Ein Fragenelement, mit dem der Teilnehmer ein oder mehrere Kästchen auswählen kann, sowie ein optionales Feld „Sonstiges“. Elemente können über ein Form
aufgerufen oder erstellt werden. Wenn Sie sie in einem Quiz verwenden, werden sie automatisch benotet.
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
clearValidation() | CheckboxItem | Entfernt alle Datenvalidierungen für dieses Kästchen. |
createChoice(value) | Choice | Erstellt eine neue Auswahl. |
createChoice(value, isCorrect) | Choice | Erstellt eine neue Auswahl. |
createResponse(responses) | ItemResponse | Erstellt eine neue ItemResponse für dieses Kästchen. |
duplicate() | CheckboxItem | Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an. |
getChoices() | Choice[] | Ruft alle Optionen für ein Element ab. |
getFeedbackForCorrect() | QuizFeedback | Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine Frage richtig beantworten. |
getFeedbackForIncorrect() | QuizFeedback | Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie falsch auf eine 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 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 . |
hasOtherOption() | Boolean | Legt fest, ob das Element die Option „Sonstiges“ hat. |
isRequired() | Boolean | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setChoiceValues(values) | CheckboxItem | Legt die Auswahl für ein Element aus einem String-Array fest. |
setChoices(choices) | CheckboxItem | Legt ein Array von Auswahlmöglichkeiten für ein Element fest. |
setFeedbackForCorrect(feedback) | CheckboxItem | Legt fest, dass das Feedback den Teilnehmern angezeigt werden soll, wenn sie eine Frage richtig beantworten. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Sie können festlegen, dass Feedback den Teilnehmern angezeigt werden soll, wenn sie falsch auf eine Frage antworten. |
setHelpText(text) | CheckboxItem | Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems ). |
setPoints(points) | CheckboxItem | Legt die Anzahl der Punkte fest, die ein Element in einer Benotung wert ist. |
setRequired(enabled) | CheckboxItem | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setTitle(title) | CheckboxItem | Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem ) |
setValidation(validation) | CheckboxItem | Legt die Datenvalidierung für dieses Kästchenelement fest. |
showOtherOption(enabled) | CheckboxItem | Legt fest, ob das Element die Option „Sonstiges“ hat. |
Detaillierte Dokumentation
clearValidation()
Entfernt alle Datenvalidierungen für dieses Kästchen.
Zurücksenden
CheckboxItem
– dieser CheckboxItem
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
createChoice(value)
Erstellt eine neue Auswahl.
Parameter
Name | Typ | Beschreibung |
---|---|---|
value | String | Der Wert der Auswahl, den Teilnehmer beim Ansehen des Formulars als Label sehen |
Zurücksenden
Choice
— die neue Wahl
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
createChoice(value, isCorrect)
Erstellt eine neue Auswahl.
Parameter
Name | Typ | Beschreibung |
---|---|---|
value | String | Der Wert der Auswahl, den Teilnehmer beim Ansehen des Formulars als Label sehen |
isCorrect | Boolean | ob die richtige Antwort |
Zurücksenden
Choice
— die neue Wahl
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
createResponse(responses)
Erstellt eine neue ItemResponse
für dieses Kästchen. Das Argument responses
ist ein String[]
-Array mit Werten, die geprüft werden müssen. Löst eine Ausnahme aus, wenn kein Wert mit einer gültigen Auswahl für dieses Element übereinstimmt, es sei denn, showOtherOption(enabled)
ist auf true
festgelegt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
responses | String[] | Array mit gültigen Antworten für dieses Multiple-Choice-Element |
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
CheckboxItem
: ein Duplikat dieses CheckboxItem
, 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
getChoices()
Ruft alle Optionen für ein Element ab.
Zurücksenden
Choice[]
: ein Array von Auswahlmöglichkeiten
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
getFeedbackForCorrect()
Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine Frage richtig 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
getFeedbackForIncorrect()
Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie falsch auf eine Frage antworten.
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
hasOtherOption()
Legt fest, ob das Element die Option „Sonstiges“ hat.
Zurücksenden
Boolean
: true
, wenn das Element die Option „Sonstiges“ hat; 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
setChoiceValues(values)
Legt die Auswahl für ein Element aus einem String-Array fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
Parameter
Name | Typ | Beschreibung |
---|---|---|
values | String[] | Array mit Auswahlwerten, die den Umfrageteilnehmern beim Ansehen des Formulars als Labels angezeigt werden |
Zurücksenden
CheckboxItem
– dieser CheckboxItem
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
setChoices(choices)
Legt ein Array von Auswahlmöglichkeiten für ein Element fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist oder ein null
-Element enthält
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?') item.setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
choices | Choice[] | ein Array von Auswahlmöglichkeiten |
Zurücksenden
CheckboxItem
– dieser CheckboxItem
für Verkettung
Throws
Error
– Wenn das angegebene Array null
ist, leer ist oder ein null
-Element enthält
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
setFeedbackForCorrect(feedback)
Legt fest, dass das Feedback den Teilnehmern angezeigt werden soll, wenn sie eine Frage richtig beantworten.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false)]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());
Parameter
Name | Typ | Beschreibung |
---|---|---|
feedback | QuizFeedback | das neue Feedback. Bei einem Wert von null wird das Feedback gelöscht. |
Zurücksenden
CheckboxItem
– dieser CheckboxItem
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
setFeedbackForIncorrect(feedback)
Sie können festlegen, dass Feedback den Teilnehmern angezeigt werden soll, wenn sie falsch auf eine Frage antworten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
feedback | QuizFeedback | das neue Feedback |
Zurücksenden
CheckboxItem
– dieser CheckboxItem
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
CheckboxItem
– dieser CheckboxItem
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
CheckboxItem
– dieser CheckboxItem
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
CheckboxItem
: 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
CheckboxItem
– dieser CheckboxItem
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
setValidation(validation)
Legt die Datenvalidierung für dieses Kästchenelement fest. Wenn Sie null oder eine Validierung übergeben, ohne dass aufgerufene Funktionen erforderlich zu sein, wird jede vorherige Validierung entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
validation | CheckboxValidation | Eine Kästchenprüfung, die auf dieses Element angewendet werden soll. |
Zurücksenden
CheckboxItem
– dieser CheckboxItem
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
showOtherOption(enabled)
Legt fest, ob das Element die Option „Sonstiges“ hat. Die Standardeinstellung für eine neue CheckboxItem
oder MultipleChoiceItem
ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn der Artikel die Option „Sonstiges“ hat; false , wenn nicht |
Zurücksenden
CheckboxItem
– dieser CheckboxItem
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