Ein Frageelement, mit dem die Befragten eine Tageszeit 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 time item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addTimeItem(); item.setTitle('What time do you usually wake up in the morning?');
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
createResponse(hour, minute) | ItemResponse | Erstellt ein neues ItemResponse für dieses Zeitelement. |
duplicate() | TimeItem | Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein. |
getGeneralFeedback() | QuizFeedback | Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten. |
getHelpText() | String | Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems bezeichnet). |
getId() | Integer | Die eindeutige Kennung des Artikels. |
getIndex() | Integer | Ruft den Index des Elements unter allen Elementen im Formular ab. |
getPoints() | Integer | Gibt die Punktzahl eines benoteten Elements zurück. |
getTitle() | String | Der Titel des Artikels (im Fall eines SectionHeaderItem auch als Headertext bezeichnet). |
getType() | ItemType | Der Typ des Artikels, dargestellt als ItemType . |
isRequired() | Boolean | Bestimmt, ob die Befragten die Frage beantworten müssen. |
setGeneralFeedback(feedback) | TimeItem | 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). |
setHelpText(text) | TimeItem | Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie ImageItems , PageBreakItems und SectionHeaderItems auch als Beschreibungstext bezeichnet). |
setPoints(points) | TimeItem | Hiermit wird die Anzahl der Punkte festgelegt, die ein benotetes Element wert ist. |
setRequired(enabled) | TimeItem | Hier legen Sie fest, ob die Befragten die Frage beantworten müssen. |
setTitle(title) | TimeItem | Hiermit wird der Titel des Artikels festgelegt (im Fall eines SectionHeaderItem auch als Headertext bezeichnet). |
Detaillierte Dokumentation
createResponse(hour, minute)
Erstellt ein neues ItemResponse
für dieses Zeitelement. Die Argumente hour
und minute
sollten als Ganzzahlen von 0
bis 23
bzw. von 0
bis 59
dargestellt werden. Werden diese Grenzen überschritten, verhalten sie sich wie eine Uhr: 10, 90
wird beispielsweise als 11:30 Uhr und -1, 60
als 00:00 Uhr interpretiert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
hour | Integer | Die Stunde als Ganzzahl von 0 bis 23 |
minute | Integer | die Minute der Stunde, dargestellt als Ganzzahl von 0 bis 59 |
Rückflug
ItemResponse
– 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
TimeItem
– Duplikat dieses TimeItem
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
getGeneralFeedback()
Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten.
Rückflug
QuizFeedback
: 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
getHelpText()
Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
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
getId()
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
getIndex()
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
getPoints()
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
getTitle()
Der Titel des Artikels (im Fall einer SectionHeaderItem
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
getType()
Der Typ des Artikels, dargestellt als ItemType
.
Rückflug
ItemType
: 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
isRequired()
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
setGeneralFeedback(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 | QuizFeedback | das neue Feedback |
Rückflug
TimeItem
– dieses TimeItem
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
setHelpText(text)
Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie ImageItems
, PageBreakItems
und SectionHeaderItems
auch als Beschreibungstext bezeichnet).
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den neuen Hilfetext |
Rückflug
TimeItem
– dieses TimeItem
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
setPoints(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
TimeItem
– dieses TimeItem
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
setRequired(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
TimeItem
– 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
setTitle(title)
Hiermit wird der Titel des Artikels festgelegt (im Fall eines SectionHeaderItem
auch als Headertext bezeichnet).
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | den neuen Titel oder Headertext |
Rückflug
TimeItem
– dieses TimeItem
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