Ein Frageelement, mit dem Teilnehmer ein Datum angeben können. Elemente können aufgerufen oder erstellt werden
von einem Form
. Diese Elemente werden in einem Quiz benotet.
// Open a form by ID and add a new date item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addDateItem(); item.setTitle('When were you born?');
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
createResponse(response) | ItemResponse | Erstellt eine neue ItemResponse für dieses Datum. |
duplicate() | DateItem | Erstellt eine Kopie dieses Elements und hängt sie am Ende des Formulars an. |
getGeneralFeedback() | QuizFeedback | Gibt das Feedback zurück, das die Befragten sehen, wenn sie auf eine benotete Frage antworten. |
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 Kennzeichnung des Artikels ab. |
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 | Ruft den Titel des Elements ab. Wird manchmal als Überschrifttext bezeichnet, im Fall von SectionHeaderItem . |
getType() | ItemType | Ruft den Typ des Elements ab, dargestellt als ItemType . |
includesYear() | Boolean | Legt fest, ob das Datumselement eine Jahresoption enthält. |
isRequired() | Boolean | Bestimmt, ob der Teilnehmer die Frage beantworten muss. |
setGeneralFeedback(feedback) | DateItem | Legt fest, dass das Feedback den Befragten angezeigt wird, wenn diese auf eine benotete Frage antworten, die keine richtige oder falsche Antwort (z. B. Fragen, die eine manuelle Benotung erfordern) hat. |
setHelpText(text) | DateItem | Legt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems bezeichnet). |
setIncludesYear(enableYear) | DateItem | Legt fest, ob das Datumselement eine Jahreseinstellung enthält. |
setPoints(points) | DateItem | Legt die Anzahl der Punkte fest, die ein benotetes Element wert ist. |
setRequired(enabled) | DateItem | Legt fest, ob der Befragte die Frage beantworten muss. |
setTitle(title) | DateItem | Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem ). |
Detaillierte Dokumentation
createResponse(response)
Erstellt eine neue ItemResponse
für dieses Datum. Die Zeitfelder von Date
werden ignoriert. Standardmäßig werden nur die Felder für Jahr, Monat und Tag verwendet. Ist setIncludesYear(enabled)
auf false
gesetzt, ist das Jahr
werden ebenfalls ignoriert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
response | Date | Ein Date -Objekt, das einen Monat, einen Tag und möglicherweise ein Jahr darstellt |
Rückflug
ItemResponse
– die Elementantwort
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 am Ende des Formulars an.
Rückflug
DateItem
– ein Duplikat von DateItem
, für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGeneralFeedback()
Gibt das Feedback zurück, das die Befragten sehen, wenn sie auf eine benotete Frage antworten.
Rückflug
QuizFeedback
: das Feedback, falls vorhanden.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
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.
Rückflug
String
: Hilfe- oder Beschreibungstext des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige Kennzeichnung des Artikels ab.
Rückflug
Integer
: die ID des Artikels
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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
– Index des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 Anzahl der Punkte, die eine Frage wert ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab. Wird manchmal als Überschrifttext bezeichnet, im Fall von SectionHeaderItem
.
Rückflug
String
: Titel oder Text der Überschrift des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Ruft den Typ des Elements ab, dargestellt als ItemType
.
Rückflug
ItemType
– Typ des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
includesYear()
Legt fest, ob das Datumselement eine Jahresoption enthält.
Rückflug
Boolean
: true
, wenn das Datum eine Jahreseinstellung enthält. false
wenn nicht
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Bestimmt, ob der Teilnehmer die Frage beantworten muss.
Rückflug
Boolean
– ob der Teilnehmer die Frage beantworten muss
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Legt fest, dass das Feedback den Befragten angezeigt wird, wenn diese auf eine benotete Frage antworten, die keine richtige oder falsche Antwort (z. B. Fragen, die eine manuelle Benotung erfordern) hat.
Parameter
Name | Typ | Beschreibung |
---|---|---|
feedback | QuizFeedback | das neue Feedback |
Rückflug
DateItem
– diese DateItem
, für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
bezeichnet).
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den neuen Hilfetext |
Rückflug
DateItem
– diese DateItem
, für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setIncludesYear(enableYear)
Legt fest, ob das Datumselement eine Jahreseinstellung enthält. Der Standardwert für neue Datumselemente ist true
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enableYear | Boolean | true , wenn das Datum eine Jahreseinstellung enthält; false wenn nicht |
Rückflug
DateItem
– diese DateItem
, für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
Legt die Anzahl der Punkte fest, 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 eine Frage wert ist |
Rückflug
DateItem
– diese DateItem
, für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Legt fest, ob der Befragte die Frage beantworten muss.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | ob der Befragte die Frage beantworten muss. |
Rückflug
DateItem
– das aktuelle Element (für Verkettung)
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem
).
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | den neuen Titel oder Überschriftentext |
Rückflug
DateItem
– diese DateItem
, für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms