Ein Frageelement, mit dem der Teilnehmer ein oder mehrere Kästchen auswählen kann, sowie ein optionales Feld "Sonstiges". Elemente können über Form
aufgerufen oder erstellt werden. Diese Elemente werden automatisch benotet, wenn sie in einem Quiz verwendet werden.
// 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ästchenelement. |
createChoice(value) | Choice | Erstellt eine neue Auswahl. |
createChoice(value, isCorrect) | Choice | Erstellt eine neue Auswahl. |
createResponse(responses) | ItemResponse | Erstellt ein neues ItemResponse -Element für dieses Kästchenelement. |
duplicate() | CheckboxItem | Erstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an. |
getChoices() | Choice[] | Ruft alle Auswahlmöglichkeiten für ein Element ab. |
getFeedbackForCorrect() | QuizFeedback | Gibt das Feedback zurück, das den Befragten angezeigt wird, wenn sie eine Frage richtig beantworten. |
getFeedbackForIncorrect() | QuizFeedback | Gibt das Feedback zurück, das den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten. |
getHelpText() | String | den Hilfetext des Elements abrufen (manchmal als Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems bezeichnet) |
getId() | Integer | Ruft die eindeutige ID des Artikels ab. |
getIndex() | Integer | Ruft den Index des Elements aus allen Elementen im Formular ab. |
getPoints() | Integer | Gibt die Punktzahl eines benotbaren Elements zurück. |
getTitle() | String | Ruft den Titel des Elements ab (im Fall eines SectionHeaderItem -Elements manchmal auch als Überschrifttext bezeichnet). |
getType() | ItemType | Ruft den Typ des Elements ab, dargestellt als ItemType . |
hasOtherOption() | Boolean | Legt fest, ob das Element über die Option „Sonstiges“ verfügt. |
isRequired() | Boolean | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setChoiceValues(values) | CheckboxItem | Legt die Auswahlmöglichkeiten für ein Element aus einem String-Array fest. |
setChoices(choices) | CheckboxItem | Legt ein Array mit Auswahlmöglichkeiten für ein Element fest. |
setFeedbackForCorrect(feedback) | CheckboxItem | Legt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage richtig beantworten. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Legt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten. |
setHelpText(text) | CheckboxItem | Legt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems , PageBreakItems und SectionHeaderItems wird dieser Text manchmal auch als Beschreibungstext bezeichnet. |
setPoints(points) | CheckboxItem | Legt die Anzahl der Punkte fest, die ein benotbares Element wert ist. |
setRequired(enabled) | CheckboxItem | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setTitle(title) | CheckboxItem | Legt den Titel des Elements fest. Bei SectionHeaderItem wird dieser Text manchmal auch als Überschrifttext bezeichnet. |
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ästchenelement.
Return
CheckboxItem
– dieses CheckboxItem
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
createChoice(value)
Erstellt eine neue Auswahl.
Parameter
Name | Typ | Beschreibung |
---|---|---|
value | String | den Wert der Auswahl, den die Befragten als Label sehen, wenn sie das Formular aufrufen |
Return
Choice
– die neue Auswahlmöglichkeit
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
createChoice(value, isCorrect)
Erstellt eine neue Auswahl.
Parameter
Name | Typ | Beschreibung |
---|---|---|
value | String | den Wert der Auswahl, den die Befragten als Label sehen, wenn sie das Formular aufrufen |
isCorrect | Boolean | ob die Antwort richtig ist |
Return
Choice
– die neue Auswahlmöglichkeit
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
createResponse(responses)
Erstellt ein neues ItemResponse
-Element für dieses Kästchenelement. Das Argument responses
ist ein String[]
-Array mit Werten, die geprüft werden müssen. Löst eine Ausnahme aus, wenn ein Wert mit keiner gültigen Auswahl für dieses Element übereinstimmt, es sei denn, showOtherOption(enabled)
ist auf true
gesetzt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
responses | String[] | Array mit gültigen Antworten für dieses Multiple-Choice-Element |
Return
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 an das Ende des Formulars an.
Return
CheckboxItem
– ein Duplikat dieses CheckboxItem
für die 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
getChoices()
Ruft alle Auswahlmöglichkeiten für ein Element ab.
Return
Choice[]
– ein Array mit Auswahlmöglichkeiten
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
getFeedbackForCorrect()
Gibt das Feedback zurück, das den Befragten angezeigt wird, wenn sie eine Frage richtig beantworten.
Return
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
getFeedbackForIncorrect()
Gibt das Feedback zurück, das den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten.
Return
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()
den Hilfetext des Elements abrufen (manchmal als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
bezeichnet)
Return
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 ID des Artikels ab.
Return
Integer
: 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 aus allen Elementen im Formular ab.
Return
Integer
: der 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 benotbaren Elements zurück.
Return
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 (im Fall eines SectionHeaderItem
-Elements manchmal auch als Überschrifttext bezeichnet).
Return
String
: Titel oder Überschriftentext 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
.
Return
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
hasOtherOption()
Legt fest, ob das Element über die Option „Sonstiges“ verfügt.
Return
Boolean
: true
, wenn das Element eine andere Option hat; 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()
Legt fest, ob der Teilnehmer die Frage beantworten muss.
Return
Boolean
: Gibt an, 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
setChoiceValues(values)
Legt die Auswahlmöglichkeiten 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 der Auswahlwerte, die die Befragten beim Aufrufen des Formulars als Labels sehen |
Return
CheckboxItem
– dieses CheckboxItem
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
setChoices(choices)
Legt ein Array mit 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 mit Auswahlmöglichkeiten |
Return
CheckboxItem
– dieses CheckboxItem
für Verkettung
Löst aus
Error
– wenn das angegebene Array null
ist, leer ist oder ein null
-Element enthält
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
setFeedbackForCorrect(feedback)
Legt fest, dass das Feedback den Befragten angezeigt wird, 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 Nullwert wird das Feedback gelöscht. |
Return
CheckboxItem
– dieses CheckboxItem
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
setFeedbackForIncorrect(feedback)
Legt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten.
Parameter
Name | Typ | Beschreibung |
---|---|---|
feedback | QuizFeedback | das neue Feedback |
Return
CheckboxItem
– dieses CheckboxItem
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. Bei Layoutelementen wie ImageItems
, PageBreakItems
und SectionHeaderItems
wird dieser Text manchmal auch als Beschreibungstext bezeichnet.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | dem neuen Hilfetext |
Return
CheckboxItem
– dieses CheckboxItem
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 benotbares 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 |
Return
CheckboxItem
– dieses CheckboxItem
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 Teilnehmer die Frage beantworten muss.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | ob der Befragte die Frage beantworten muss |
Return
CheckboxItem
: das aktuelle Element (zur 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. Bei SectionHeaderItem
wird dieser Text manchmal auch als Überschrifttext bezeichnet.
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | dem neuen Titel oder Text der Überschrift |
Return
CheckboxItem
– dieses CheckboxItem
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
setValidation(validation)
Legt die Datenvalidierung für dieses Kästchenelement fest. Wenn null oder eine Validierung ohne aufgerufene Anforderungsfunktionen übergeben wird, wird jede vorherige Validierung entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
validation | CheckboxValidation | eine Kästchenvalidierung, die auf dieses Element angewendet werden soll. |
Return
CheckboxItem
– dieses CheckboxItem
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
showOtherOption(enabled)
Legt fest, ob das Element die Option „Sonstiges“ hat. Der Standardwert für einen neuen CheckboxItem
oder MultipleChoiceItem
ist false
.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | true , wenn das Element die Option „Sonstiges“ hat; false , wenn nicht |
Return
CheckboxItem
– dieses CheckboxItem
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