Class VideoItem

Video Item

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 Item 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 Items , Page Break Items , and Section Header Items ).
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 Header Item ).
Item Type Gets the item's type, represented as an Item Type .
Integer Gets the video's width in pixels.
Video Item Sets the video's horizontal alignment.
Video Item Sets the item's help text (sometimes called description text for layout items like Image Items , Page Break Items , and Section Header Items ).
Video Item Sets the item's title (sometimes called header text, in the case of a Section Header Item ).
Video Item Sets the video itself from a given YouTube URL or YouTube video ID.
Video Item 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 Item — a duplicate of this Video Item , 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()

Gets the video's horizontal alignment.

Return

Alignment — the horizontal alignment

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 Help Text()

Gets the item's help text (sometimes called description text for layout items like Image Items , Page Break Items , and Section Header Items ).

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 Header Item ).

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()

Gets the item's type, represented as an Item Type .

Return

Item Type — the item's type

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 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 Item — this Video Item , 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 Items , Page Break Items , and Section Header Items ).

Parameters

Name Type Description
text
String the new help text

Return

Video Item — this Video Item , 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 Header Item ).

Parameters

Name Type Description
title
String the new title or header text

Return

Video Item — this Video Item , 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 Url
String the YouTube URL or ID

Return

Video Item — this Video Item , 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 Item — this Video Item , 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
Design a Mobile Site
View Site in Mobile | Classic
Share by: