Élément de mise en page qui affiche une vidéo. Les éléments sont accessibles ou peuvent être créés à partir d'un 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');
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
duplicate() | Video | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
get | Alignment | Récupère l'alignement horizontal de la vidéo. |
get | String | Obtient le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que Image, Page et Section). |
get | Integer | Obtient l'identifiant unique de l'élément. |
get | Integer | Obtient l'index de l'élément parmi tous les éléments du formulaire. |
get | String | Obtient le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un Section). |
get | Item | Obtient le type de l'élément, représenté sous la forme d'un Item. |
get | Integer | Récupère la largeur de la vidéo en pixels. |
set | Video | Définit l'alignement horizontal de la vidéo. |
set | Video | Définit le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que Image, Page et Section). |
set | Video | Définit le titre de l'élément (parfois appelé texte d'en-tête dans le cas d'un Section). |
set | Video | Définit la vidéo elle-même à partir d'une URL ou d'un ID de vidéo YouTube donnés. |
set | Video | Définit la largeur de la vidéo en pixels. |
Documentation détaillée
duplicate()
Crée une copie de cet élément et l'ajoute à la fin du formulaire.
Renvois
VideoItem : un double de ce VideoItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getAlignment()
Récupère l'alignement horizontal de la vidéo.
Renvois
Alignment : alignement horizontal
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getHelpText()
Obtient le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems, PageBreakItems et SectionHeaderItems).
Renvois
String : texte d'aide ou description de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
Obtient l'identifiant unique de l'élément.
Renvois
Integer : ID de l'article
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getIndex()
Obtient l'index de l'élément parmi tous les éléments du formulaire.
Renvois
Integer : index de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
Obtient le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un SectionHeaderItem).
Renvois
String : titre ou texte d'en-tête de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
Obtient le type de l'élément, représenté sous la forme d'un ItemType.
Renvois
ItemType : type de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getWidth()
Récupère la largeur de la vidéo en pixels.
Renvois
Integer : largeur en pixels
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setAlignment(alignment)
Définit l'alignement horizontal de la vidéo.
Paramètres
| Nom | Type | Description |
|---|---|---|
alignment | Alignment | l'alignement horizontal ; |
Renvois
VideoItem : VideoItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
Définit le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems, PageBreakItems et SectionHeaderItems).
Paramètres
| Nom | Type | Description |
|---|---|---|
text | String | le nouveau texte d'aide ; |
Renvois
VideoItem : VideoItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
Définit le titre de l'élément (parfois appelé texte d'en-tête dans le cas d'un SectionHeaderItem).
Paramètres
| Nom | Type | Description |
|---|---|---|
title | String | le nouveau titre ou texte d'en-tête. |
Renvois
VideoItem : VideoItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setVideoUrl(youtubeUrl)
Définit la vidéo elle-même à partir d'une URL ou d'un ID de vidéo YouTube donnés.
Paramètres
| Nom | Type | Description |
|---|---|---|
youtube | String | l'URL ou l'ID YouTube ; |
Renvois
VideoItem : VideoItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setWidth(width)
Définit la largeur de la vidéo en pixels. Seule la largeur de la vidéo peut être définie. La hauteur est définie automatiquement pour conserver les proportions de la vidéo.
Paramètres
| Nom | Type | Description |
|---|---|---|
width | Integer | la largeur en pixels. |
Renvois
VideoItem : VideoItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms