Ein Layout-Element, das ein Video anzeigt. Elemente können über ein Form
aufgerufen oder erstellt werden.
// Open a form by ID and add three new video items, using a long URL, // a short URL, and a video ID. var 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');
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
duplicate() | VideoItem | Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an. |
getAlignment() | Alignment | Ruft die horizontale Ausrichtung des Videos ab. |
getHelpText() | String | Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems bezeichnet. |
getId() | Integer | Ruft die eindeutige Kennung des Elements ab. |
getIndex() | Integer | Ruft den Index des Elements aus allen Elementen im Formular ab. |
getTitle() | String | Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem . |
getType() | ItemType | Ruft den Elementtyp ab, dargestellt als ItemType . |
getWidth() | Integer | Ruft die Breite des Videos in Pixeln ab. |
setAlignment(alignment) | VideoItem | Legt die horizontale Ausrichtung des Videos fest. |
setHelpText(text) | VideoItem | Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems ). |
setTitle(title) | VideoItem | Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem ) |
setVideoUrl(youtubeUrl) | VideoItem | Legt das Video selbst anhand einer bestimmten YouTube-URL oder YouTube-Video-ID fest. |
setWidth(width) | VideoItem | Legt die Breite des Videos in Pixeln fest. |
Detaillierte Dokumentation
duplicate()
Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an.
Zurücksenden
VideoItem
: ein Duplikat dieses VideoItem
, für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getAlignment()
Ruft die horizontale Ausrichtung des Videos ab.
Zurücksenden
Alignment
: horizontale Ausrichtung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
bezeichnet.
Zurücksenden
String
: der Hilfe- oder Beschreibungstext des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige Kennung des Elements ab.
Zurücksenden
Integer
: die ID des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Ruft den Index des Elements aus allen Elementen im Formular ab.
Zurücksenden
Integer
: Der Index des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem
.
Zurücksenden
String
: Titel oder Titel des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Ruft den Elementtyp ab, dargestellt als ItemType
.
Zurücksenden
ItemType
: Typ des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getWidth()
Ruft die Breite des Videos in Pixeln ab.
Zurücksenden
Integer
: Breite in Pixeln
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setAlignment(alignment)
Legt die horizontale Ausrichtung des Videos fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
alignment | Alignment | die horizontale Ausrichtung |
Zurücksenden
VideoItem
– dieser VideoItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
).
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den neuen Hilfetext |
Zurücksenden
VideoItem
– dieser VideoItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem
)
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | den neuen Titel oder Titel |
Zurücksenden
VideoItem
– dieser VideoItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setVideoUrl(youtubeUrl)
Legt das Video selbst anhand einer bestimmten YouTube-URL oder YouTube-Video-ID fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
youtubeUrl | String | YouTube-URL oder -ID |
Zurücksenden
VideoItem
– dieser VideoItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setWidth(width)
Legt die Breite des Videos in Pixeln fest. Nur die Breite des Videos kann festgelegt werden. Die Höhe wird automatisch festgelegt, um die Proportionen des Videos beizubehalten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
width | Integer | die Breite in Pixeln |
Zurücksenden
VideoItem
– dieser VideoItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms