Ein Frageelement, mit dem die Befragten ein Datum und eine Uhrzeit 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 date-time item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addDateTimeItem(); item.setTitle('When do you want to meet?');
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
create | Item | Erstellt eine neue Item für dieses Datum/Uhrzeit-Element. |
duplicate() | Date | 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 . |
includes | Boolean | Gibt an, ob das Datumselement eine Jahresoption enthält. |
is | Boolean | Bestimmt, ob die Befragten die Frage beantworten müssen. |
set | Date | 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 | Date | Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie Image , Page und Section auch als Beschreibungstext bezeichnet). |
set | Date | Legt fest, ob das Datumselement eine Jahreseinstellung enthält. |
set | Date | Hiermit wird die Anzahl der Punkte festgelegt, die ein benotetes Element wert ist. |
set | Date | Hier legen Sie fest, ob die Befragten die Frage beantworten müssen. |
set | Date | Hiermit wird der Titel des Artikels festgelegt (im Fall eines Section auch als Headertext bezeichnet). |
Detaillierte Dokumentation
create Response(response)
Erstellt eine neue Item
für dieses Datum/Uhrzeit-Element. Das Feld „Sekunden“ des Date
-Objekts wird ignoriert. Standardmäßig werden die Felder „Jahr“, „Monat“, „Tag“, „Stunde“ und „Minute“ verwendet. Wenn set
auf false
gesetzt ist, wird auch das Jahr ignoriert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
response | Date | ein Date -Objekt, das einen Monat, Tag, eine Stunde, Minute und möglicherweise ein Jahr darstellt |
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
Date
– Duplikat dieses Date
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
includes Year()
Gibt an, ob das Datumselement eine Jahresoption enthält.
Rückflug
Boolean
– true
, wenn das Datum eine Jahreseinstellung enthält; false
, wenn nicht
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
Date
– dieses Date
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
Date
– dieses Date
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 Includes Year(enableYear)
Legt fest, ob das Datumselement eine Jahreseinstellung enthält. Die Standardeinstellung für neue Datumselemente ist true
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enable | Boolean | true , wenn das Datum eine Jahreseinstellung enthält, false andernfalls |
Rückflug
Date
– dieses Date
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
Date
– dieses Date
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
Date
– 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
Date
– dieses Date
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