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 hängt sie an das Ende des Formulars an. |
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 eines 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 hängt sie an das Ende des Formulars an.
Rückflug
Duration – ein 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 eines 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 Verknüpfung)
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