Ein Frageelement, mit dem die Befragten eine bestimmte Zeitspanne angeben können. Auf Elemente kann über eine Form
zugegriffen oder sie können dort erstellt werden. Wenn diese Elemente in einem Quiz verwendet werden, werden sie benotet.
// Open a form by ID and add a new duration item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addDurationItem(); item.setTitle('How long can you hold your breath?');
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
create | Item | Erstellt eine neue Item für dieses Datumselement. |
duplicate() | Duration | Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein. |
get | Quiz | Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten. |
get | String | Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie Image , Page und Section bezeichnet). |
get | Integer | Die eindeutige Kennung des Artikels. |
get | Integer | Ruft den Index des Elements unter allen Elementen im Formular ab. |
get | Integer | Gibt die Punktzahl eines benoteten Elements zurück. |
get | String | Der Titel des Artikels (im Fall einer Section auch als Headertext bezeichnet). |
get | Item | Der Typ des Artikels, dargestellt als Item . |
is | Boolean | Bestimmt, ob die Befragten die Frage beantworten müssen. |
set | Duration | Hier legen Sie fest, welches Feedback den Teilnehmern angezeigt wird, wenn sie eine bewertbare Frage beantworten, die keine richtige oder falsche Antwort hat (d. h. Fragen, die manuell benotet werden müssen). |
set | Duration | Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie Image , Page und Section auch als Beschreibungstext bezeichnet). |
set | Duration | Hiermit wird die Anzahl der Punkte festgelegt, die ein benotetes Element wert ist. |
set | Duration | Hier legen Sie fest, ob die Befragten die Frage beantworten müssen. |
set | Duration | Hiermit wird der Titel des Artikels festgelegt (im Fall eines Section auch als Headertext bezeichnet). |
Detaillierte Dokumentation
create Response(hours, minutes, seconds)
Erstellt eine neue Item
für dieses Datumselement. Die Argumente hours
, minutes
und seconds
sollten als ganze Zahlen zwischen 0
und 72
für hours
und zwischen 0
und 59
für minutes
und seconds
dargestellt werden. Werte, die diese Grenzen überschreiten, werden begrenzt: 24, 60, 90
wird beispielsweise als 24:59:59 interpretiert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
hours | Integer | die Stunden, dargestellt als Ganzzahl von 0 bis 72 |
minutes | Integer | die Minuten als Ganzzahl von 0 bis 59 |
seconds | Integer | die Sekunden, dargestellt als Ganzzahl von 0 bis 59 |
Rückflug
Item
– die Artikelantwort
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.
Rückflug
Duration
– Duplikat dieses Duration
zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get General Feedback()
Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten.
Rückflug
Quiz
: gegebenenfalls das Feedback
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Help Text()
Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie Image
, Page
und Section
bezeichnet).
Rückflug
String
: Hilfetext oder Beschreibung des Artikels
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Id()
Die eindeutige Kennung des Artikels.
Rückflug
Integer
: die Artikel-ID
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Index()
Ruft den Index des Elements unter allen Elementen im Formular ab.
Rückflug
Integer
: der Index des Artikels
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Points()
Gibt die Punktzahl eines benoteten Elements zurück.
Rückflug
Integer
: Die Punktzahl, die eine Frage wert ist.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Title()
Der Titel des Artikels (im Fall einer Section
auch als Headertext bezeichnet).
Rückflug
String
– Titel oder Headertext des Artikels
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Type()
Der Typ des Artikels, dargestellt als Item
.
Rückflug
Item
: Der Typ des Artikels.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
is Required()
Bestimmt, ob die Befragten die Frage beantworten müssen.
Rückflug
Boolean
– ob die Befragten die Frage beantworten müssen
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set General Feedback(feedback)
Hier legen Sie fest, welches Feedback den Teilnehmern angezeigt wird, wenn sie eine bewertbare Frage beantworten, die keine richtige oder falsche Antwort hat (d. h. Fragen, die manuell benotet werden müssen).
Parameter
Name | Typ | Beschreibung |
---|---|---|
feedback | Quiz | das neue Feedback |
Rückflug
Duration
– dieses Duration
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Help Text(text)
Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie Image
, Page
und Section
auch als Beschreibungstext bezeichnet).
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den neuen Hilfetext |
Rückflug
Duration
– dieses Duration
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Points(points)
Hiermit wird die Anzahl der Punkte festgelegt, die ein benotetes Element wert ist. Der Standardwert für neue Elemente ist 0.
Parameter
Name | Typ | Beschreibung |
---|---|---|
points | Integer | die Anzahl der Punkte, die ein Frageelement wert ist |
Rückflug
Duration
– dieses Duration
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Required(enabled)
Hier legen Sie fest, ob die Befragten die Frage beantworten müssen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | ob die Befragten die Frage beantworten müssen |
Rückflug
Duration
– das aktuelle Element (für die Verkettung)
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Title(title)
Hiermit wird der Titel des Artikels festgelegt (im Fall eines Section
auch als Headertext bezeichnet).
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | den neuen Titel oder Headertext |
Rückflug
Duration
– dieses Duration
für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms