A layout item that displays a video. Items can be accessed or created from a Form
.
// Open a form by ID and add three new video items, using a long URL, // a short URL, and a video ID. const form = FormApp . openById ( '1234567890abcdefghijklmnopqrstuvwxyz' ); form . addVideoItem () . setTitle ( 'Video Title' ) . setHelpText ( 'Video Caption' ) . setVideoUrl ( 'www.youtube.com/watch?v=1234abcdxyz' ); form . addVideoItem () . setTitle ( 'Video Title' ) . setHelpText ( 'Video Caption' ) . setVideoUrl ( 'youtu.be/1234abcdxyz' ); form . addVideoItem () . setTitle ( 'Video Title' ) . setHelpText ( 'Video Caption' ) . setVideoUrl ( '1234abcdxyz' );
Methods
Method | Return type | Brief description |
---|---|---|
Video
|
Creates a copy of this item and appends it to the end of the form. | |
Alignment
|
Gets the video's horizontal alignment. | |
String
|
Gets the item's help text (sometimes called description text for layout items like Image
, Page
, and Section
). |
|
Integer
|
Gets the item's unique identifier. | |
Integer
|
Gets the index of the item among all the items in the form. | |
String
|
Gets the item's title (sometimes called header text, in the case of a Section
). |
|
Item
|
Gets the item's type, represented as an Item
. |
|
Integer
|
Gets the video's width in pixels. | |
Video
|
Sets the video's horizontal alignment. | |
Video
|
Sets the item's help text (sometimes called description text for layout items like Image
, Page
, and Section
). |
|
Video
|
Sets the item's title (sometimes called header text, in the case of a Section
). |
|
Video
|
Sets the video itself from a given YouTube URL or YouTube video ID. | |
Video
|
Sets the video's width in pixels. |
Detailed documentation
duplicate()
Creates a copy of this item and appends it to the end of the form.
Return
Video
— a duplicate of this Video
, for chaining
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get
Alignment()
get
Help
Text()
Gets the item's help text (sometimes called description text for layout items like Image
, Page
, and Section
).
Return
String
— the item's help text or description text
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get
Id()
Gets the item's unique identifier.
Return
Integer
— the item's ID
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get
Index()
Gets the index of the item among all the items in the form.
Return
Integer
— the index of the item
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get
Title()
Gets the item's title (sometimes called header text, in the case of a Section
).
Return
String
— the item's title or header text
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get
Type()
get
Width()
Gets the video's width in pixels.
Return
Integer
— the width in pixels
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set
Alignment(alignment)
Sets the video's horizontal alignment.
Parameters
Name | Type | Description |
---|---|---|
alignment
|
Alignment
|
the horizontal alignment |
Return
Video
— this Video
, for chaining
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set
Help
Text(text)
Sets the item's help text (sometimes called description text for layout items like Image
, Page
, and Section
).
Parameters
Name | Type | Description |
---|---|---|
text
|
String
|
the new help text |
Return
Video
— this Video
, for chaining
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set
Title(title)
Sets the item's title (sometimes called header text, in the case of a Section
).
Parameters
Name | Type | Description |
---|---|---|
title
|
String
|
the new title or header text |
Return
Video
— this Video
, for chaining
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set
Video
Url(youtubeUrl)
Sets the video itself from a given YouTube URL or YouTube video ID.
Parameters
Name | Type | Description |
---|---|---|
youtube
|
String
|
the YouTube URL or ID |
Return
Video
— this Video
, for chaining
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set
Width(width)
Sets the video's width in pixels. Only the video's width can be set. Height is set automatically to maintain the video's proportions.
Parameters
Name | Type | Description |
---|---|---|
width
|
Integer
|
the width in pixels |
Return
Video
— this Video
, for chaining
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms