Diese Seite wurde von der Cloud Translation API übersetzt.

Class MultipleChoiceItem

Ein Frageelement, bei dem die Person eine Option aus einer Liste von Optionsfeldern oder einem optionalen Feld „Sonstiges“ auswählen kann. Auf Elemente kann über ein Form zugegriffen oder sie können dort erstellt werden. Wenn diese Elemente in einem Quiz verwendet werden, werden sie automatisch benotet.

// Open a form by ID and add a new multiple choice item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([item.createChoice('Cats'), item.createChoice('Dogs')])
    .showOtherOption(true);

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`createChoice(value)`	`Choice`	Erstellt eine neue Auswahl.
`createChoice(value, isCorrect)`	`Choice`	Erstellt eine neue Option.
`createChoice(value, navigationItem)`	`Choice`	Erstellt eine neue Auswahl mit einer Seitennavigationsoption, die zu einem bestimmten Seitenumbruchelement springt.
`createChoice(value, navigationType)`	`Choice`	Erstellt eine neue Auswahl mit einer Option für die Seitennavigation.
`createResponse(response)`	`ItemResponse`	Erstellt ein neues `ItemResponse` für dieses Multiple-Choice-Element.
`duplicate()`	`MultipleChoiceItem`	Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.
`getChoices()`	`Choice[]`	Hiermit werden alle Optionen für einen Artikel abgerufen.
`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 eine Frage falsch 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 einer `SectionHeaderItem` auch als Headertext bezeichnet).
`getType()`	`ItemType`	Der Typ des Artikels, dargestellt als `ItemType`.
`hasOtherOption()`	`Boolean`	Gibt an, ob für das Element die Option „Sonstiges“ verfügbar ist.
`isRequired()`	`Boolean`	Bestimmt, ob die Befragten die Frage beantworten müssen.
`setChoiceValues(values)`	`MultipleChoiceItem`	Legt die Auswahlmöglichkeiten für einen Artikel aus einem String-Array fest.
`setChoices(choices)`	`MultipleChoiceItem`	Legt eine Reihe von Auswahlmöglichkeiten für einen Artikel fest.
`setFeedbackForCorrect(feedback)`	`MultipleChoiceItem`	Hier legen Sie fest, welches Feedback den Teilnehmern angezeigt wird, wenn sie eine Frage richtig beantworten.
`setFeedbackForIncorrect(feedback)`	`MultipleChoiceItem`	Hier legen Sie fest, welches Feedback den Teilnehmern angezeigt wird, wenn sie eine Frage falsch beantworten.
`setHelpText(text)`	`MultipleChoiceItem`	Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` auch als Beschreibungstext bezeichnet).
`setPoints(points)`	`MultipleChoiceItem`	Hiermit wird die Anzahl der Punkte festgelegt, die ein benotetes Element wert ist.
`setRequired(enabled)`	`MultipleChoiceItem`	Hier legen Sie fest, ob die Befragten die Frage beantworten müssen.
`setTitle(title)`	`MultipleChoiceItem`	Hiermit wird der Titel des Artikels festgelegt (im Fall eines `SectionHeaderItem` auch als Headertext bezeichnet).
`showOtherOption(enabled)`	`MultipleChoiceItem`	Gibt an, ob für das Element die Option „Sonstiges“ verfügbar ist.

Detaillierte Dokumentation

`createChoice(value)`

Erstellt eine neue Auswahl.

Parameter

Name	Typ	Beschreibung
`value`	`String`	Der Wert der Auswahl, der den Teilnehmern im Formular als Label angezeigt wird

Rückflug

Choice – die neue Wahl

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

`createChoice(value, isCorrect)`

Erstellt eine neue Auswahl.

Parameter

Name	Typ	Beschreibung
`value`	`String`	Der Wert der Auswahl, der den Teilnehmern im Formular als Label angezeigt wird
`isCorrect`	`Boolean`	ob die Auswahl eine richtige Antwort ist

Rückflug

Choice – die neue Wahl

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

`createChoice(value, navigationItem)`

Erstellt eine neue Auswahl mit einer Seitennavigationsoption, die zu einem bestimmten Seitenumbruchelement springt. Dies entspricht createChoice(value, navigationType), wobei navigationType auf FormApp.PageNavigationType.GO_TO_PAGE festgelegt ist. Optionen, die die Seitennavigation verwenden, können nicht im selben Element mit Optionen kombiniert werden, die keine Seitennavigation verwenden.

Die Seitennavigation erfolgt, nachdem der Teilnehmer eine Seite mit der Option abgeschlossen hat, und nur, wenn er diese Option ausgewählt hat. Wenn der Teilnehmer mehrere Optionen mit Anleitungen zur Seitennavigation auf derselben Seite ausgewählt hat, hat nur die letzte Navigationsoption eine Auswirkung. Die Seitennavigation hat auch keine Auswirkungen auf die letzte Seite eines Formulars.

Parameter

Name	Typ	Beschreibung
`value`	`String`	der Wert der Auswahl, der den Teilnehmern im Formular als Label angezeigt wird
`navigationItem`	`PageBreakItem`	das Element, zu dem Sie wechseln möchten

Rückflug

Choice – die neue Wahl

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

`createChoice(value, navigationType)`

Erstellt eine neue Auswahl mit einer Option für die Seitennavigation. Optionen, die die Seitennavigation verwenden, können nicht im selben Element mit Optionen kombiniert werden, die keine Seitennavigation verwenden.

Parameter

Name	Typ	Beschreibung
`value`	`String`	der Wert der Auswahl, der den Teilnehmern im Formular als Label angezeigt wird
`navigationType`	`PageNavigationType`	den Navigationstyp der Auswahl

Rückflug

Choice – die neue Wahl

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

`createResponse(response)`

Erstellt ein neues ItemResponse für dieses Multiple-Choice-Element. Löst eine Ausnahme aus, wenn das Argument response nicht mit einer gültigen Auswahl für dieses Element übereinstimmt, es sei denn, showOtherOption(enabled) ist auf true festgelegt.

Parameter

Name	Typ	Beschreibung
`response`	`String`	eine gültige Antwort für dieses Multiple-Choice-Element

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

MultipleChoiceItem – Duplikat dieses MultipleChoiceItem 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

`getChoices()`

Hiermit werden alle Optionen für einen Artikel abgerufen.

Rückflug

Choice[] – eine Auswahl

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

`getFeedbackForCorrect()`

Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine Frage richtig 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

`getFeedbackForIncorrect()`

Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine Frage falsch 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

`hasOtherOption()`

Gibt an, ob für das Element die Option „Sonstiges“ verfügbar ist.

Rückflug

Boolean – true, wenn für den Artikel die Option „Sonstiges“ verfügbar ist; false, wenn nicht

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

`setChoiceValues(values)`

Legt die Auswahlmöglichkeiten für einen Artikel 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parameter

Name	Typ	Beschreibung
`values`	`String[]`	die Auswahlwerte, die den Teilnehmern im Formular als Labels angezeigt werden

Rückflug

MultipleChoiceItem – dieses MultipleChoiceItem 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

`setChoices(choices)`

Hiermit wird eine Reihe von Auswahlmöglichkeiten für einen Artikel festgelegt. 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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[]`	eine Reihe von Optionen

Rückflug

MultipleChoiceItem – dieses MultipleChoiceItem für die Verkettung

Löst aus

Error – wenn das angegebene Array null ist, leer ist oder ein null-Element enthält

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

`setFeedbackForCorrect(feedback)`

Hier legen Sie fest, welches Feedback den Teilnehmern angezeigt wird, wenn sie eine Frage richtig beantworten.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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.

Rückflug

MultipleChoiceItem – dieses MultipleChoiceItem 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

`setFeedbackForIncorrect(feedback)`

Hier legen Sie fest, welches Feedback den Teilnehmern angezeigt wird, wenn sie eine Frage falsch beantworten.

Parameter

Name	Typ	Beschreibung
`feedback`	`QuizFeedback`	das neue Feedback

Rückflug

MultipleChoiceItem – dieses MultipleChoiceItem 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

MultipleChoiceItem – dieses MultipleChoiceItem 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

MultipleChoiceItem – dieses MultipleChoiceItem 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

MultipleChoiceItem – 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

MultipleChoiceItem – dieses MultipleChoiceItem 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

`showOtherOption(enabled)`

Gibt an, ob für das Element die Option „Sonstiges“ verfügbar ist. Der Standardwert für eine neue CheckboxItem oder MultipleChoiceItem ist false.

Parameter

Name	Typ	Beschreibung
`enabled`	`Boolean`	`true`, wenn für das Element die Option „Sonstiges“ verfügbar ist, `false` andernfalls

Rückflug

MultipleChoiceItem – dieses MultipleChoiceItem 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