Eine Frage, bei der der Teilnehmer ein Datum angeben kann. Elemente können über ein Form
aufgerufen oder erstellt werden. Wenn Sie sie in einem Quiz verwenden, werden sie 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 Datumselement. |
duplicate() | DateItem | Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an. |
getGeneralFeedback() | QuizFeedback | Gibt das Feedback zurück, das Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten. |
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 Kennung des Elements ab. |
getIndex() | Integer | Ruft den Index des Elements aus allen Elementen im Formular ab. |
getPoints() | Integer | Gibt die Punktzahl eines benotebaren Elements zurück. |
getTitle() | String | Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem . |
getType() | ItemType | Ruft den Elementtyp ab, dargestellt als ItemType . |
includesYear() | Boolean | Legt fest, ob das Datumselement eine Jahresoption enthält. |
isRequired() | Boolean | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setGeneralFeedback(feedback) | DateItem | Legt das Feedback fest, das Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten, die keine richtige oder falsche Antwort enthält (d. h. Fragen, für die eine manuelle Benotung erforderlich ist). |
setHelpText(text) | DateItem | Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems ). |
setIncludesYear(enableYear) | DateItem | Gibt an, ob der Datumseintrag eine Jahreseinstellung enthält. |
setPoints(points) | DateItem | Legt die Anzahl der Punkte fest, die ein Element in einer Benotung wert ist. |
setRequired(enabled) | DateItem | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setTitle(title) | DateItem | Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem ) |
Detaillierte Dokumentation
createResponse(response)
Erstellt eine neue ItemResponse
für dieses Datumselement. Die Zeitfelder des Date
-Objekts werden ignoriert. Standardmäßig werden nur die Felder für Jahr, Monat und Tag verwendet. Wenn setIncludesYear(enabled)
auf false
gesetzt ist, wird auch das Jahr ignoriert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
response | Date | Ein Date -Objekt, das einen Monat, einen Tag und möglicherweise ein Jahr darstellt |
Zurücksenden
ItemResponse
: die Antwort des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an.
Zurücksenden
DateItem
: ein Duplikat dieses DateItem
, für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGeneralFeedback()
Gibt das Feedback zurück, das Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten.
Zurücksenden
QuizFeedback
: Das Feedback, falls vorhanden.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
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.
Zurücksenden
String
: der Hilfe- oder Beschreibungstext des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige Kennung des Elements ab.
Zurücksenden
Integer
: die ID des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Ruft den Index des Elements aus allen Elementen im Formular ab.
Zurücksenden
Integer
: Der Index des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPoints()
Gibt die Punktzahl eines benotebaren Elements zurück.
Zurücksenden
Integer
: Gibt an, wie viele Punkte eine Frage hat.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem
.
Zurücksenden
String
: Titel oder Titel des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Ruft den Elementtyp ab, dargestellt als ItemType
.
Zurücksenden
ItemType
: Typ des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
includesYear()
Legt fest, ob das Datumselement eine Jahresoption enthält.
Zurücksenden
Boolean
: true
, wenn das Datum eine Jahreseinstellung enthält; false
wenn nicht
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Legt fest, ob der Teilnehmer die Frage beantworten muss.
Zurücksenden
Boolean
: Gibt an, ob der Teilnehmer die Frage beantworten muss
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Legt das Feedback fest, das Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten, die keine richtige oder falsche Antwort enthält (d. h. Fragen, für die eine manuelle Benotung erforderlich ist).
Parameter
Name | Typ | Beschreibung |
---|---|---|
feedback | QuizFeedback | das neue Feedback |
Zurücksenden
DateItem
– dieser DateItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
).
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den neuen Hilfetext |
Zurücksenden
DateItem
– dieser DateItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setIncludesYear(enableYear)
Gibt an, ob der Datumseintrag eine Jahreseinstellung enthält. Die Standardeinstellung für neue Datumselemente ist true
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enableYear | Boolean | true , wenn das Datum eine Jahreseinstellung enthält; false wenn nicht |
Zurücksenden
DateItem
– dieser DateItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
Legt die Anzahl der Punkte fest, die ein Element in einer Benotung wert ist. Der Standardwert für neue Elemente ist 0.
Parameter
Name | Typ | Beschreibung |
---|---|---|
points | Integer | die Anzahl der Punkte, die ein Frageartikel wert ist |
Zurücksenden
DateItem
– dieser DateItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Legt fest, ob der Teilnehmer die Frage beantworten muss.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | ob der Teilnehmer die Frage beantworten muss |
Zurücksenden
DateItem
: das aktuelle Element (zum Verketten)
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem
)
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | den neuen Titel oder Titel |
Zurücksenden
DateItem
– dieser DateItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms