Diese Seite wurde von der Cloud Translation API übersetzt.

Class MultipleChoiceItem

Eine Frage, mit der die Befragten eine Antwort aus einer Liste von Optionsfeldern oder optional „Sonstiges“ ein. Elemente können über ein Form erstellt oder aufgerufen werden. Bei Verwendung in einem Quizfragen beantwortet wurden, werden diese Elemente automatisch benotet.

// Open a form by ID and add a new multiple choice item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 Auswahl.
`createChoice(value, navigationItem)`	`Choice`	Erstellt eine neue Auswahl mit einer Seitennavigationsoption, die zu einem bestimmten Element für den Seitenumbruch springt.
`createChoice(value, navigationType)`	`Choice`	Erstellt eine neue Auswahl mit einer Seitennavigationsoption.
`createResponse(response)`	`ItemResponse`	Erstellt eine neue `ItemResponse` für dieses Multiple-Choice-Element
`duplicate()`	`MultipleChoiceItem`	Erstellt eine Kopie dieses Elements und hängt sie am Ende des Formulars an.
`getChoices()`	`Choice[]`	Ruft alle Auswahlmöglichkeiten für ein Element ab.
`getFeedbackForCorrect()`	`QuizFeedback`	Gibt das Feedback zurück, das die Befragten sehen, wenn sie eine Frage richtig beantworten.
`getFeedbackForIncorrect()`	`QuizFeedback`	Gibt das Feedback zurück, das die Befragten sehen, wenn sie eine Frage falsch 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 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`.
`hasOtherOption()`	`Boolean`	Bestimmt, ob das Element „Sonstiges“ hat Option.
`isRequired()`	`Boolean`	Bestimmt, ob der Teilnehmer die Frage beantworten muss.
`setChoiceValues(values)`	`MultipleChoiceItem`	Legt die Auswahlmöglichkeiten für ein Element aus einem String-Array fest.
`setChoices(choices)`	`MultipleChoiceItem`	Legt ein Array von Auswahlmöglichkeiten für ein Element fest.
`setFeedbackForCorrect(feedback)`	`MultipleChoiceItem`	Legt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage richtig beantworten.
`setFeedbackForIncorrect(feedback)`	`MultipleChoiceItem`	Legt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten.
`setHelpText(text)`	`MultipleChoiceItem`	Legt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` bezeichnet).
`setPoints(points)`	`MultipleChoiceItem`	Legt die Anzahl der Punkte fest, die ein benotetes Element wert ist.
`setRequired(enabled)`	`MultipleChoiceItem`	Legt fest, ob der Befragte die Frage beantworten muss.
`setTitle(title)`	`MultipleChoiceItem`	Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines `SectionHeaderItem`).
`showOtherOption(enabled)`	`MultipleChoiceItem`	Legt fest, ob das Element „Sonstiges“ hat Option.

Detaillierte Dokumentation

`createChoice(value)`

Erstellt eine neue Auswahl.

Parameter

Name	Typ	Beschreibung
`value`	`String`	Wert der Auswahl, der den Befragten beim Ansehen des Formulars als Label angezeigt wird

Rückflug

Choice — die neue Option

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`	Wert der Auswahl, der den Befragten beim Ansehen des Formulars als Label angezeigt wird
`isCorrect`	`Boolean`	ob die Antwort eine richtige Antwort ist,

Rückflug

Choice — die neue Option

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, navigationItem)`

Erstellt eine neue Auswahl mit einer Seitennavigationsoption, die zu einem bestimmten Element für den Seitenumbruch springt. Dieses entspricht createChoice(value, navigationType), wobei navigationType auf FormApp.PageNavigationType.GO_TO_PAGE festgelegt ist. Auswahlmöglichkeiten, die die Seite verwenden Navigation kann nicht im selben Element mit Auswahlmöglichkeiten kombiniert werden, die keine Seitennavigation verwenden.

Die Seitennavigation erfolgt, nachdem der Befragte eine Seite mit der Option abgeschlossen hat. und nur, wenn die befragte Person diese Option gewählt hat. Wenn die befragte Person mehrere Optionen mit Seitennavigationsanweisungen auf derselben Seite, hat nur die letzte Navigationsoption Auswirkungen. Die Seitennavigation hat auch keine Auswirkungen auf die letzte Seite eines Formulars.

Parameter

Name	Typ	Beschreibung
`value`	`String`	Wert der Auswahl, der den Befragten beim Ansehen des Formulars als Label angezeigt wird
`navigationItem`	`PageBreakItem`	das Element, zu dem Sie wechseln möchten,

Rückflug

Choice — die neue Option

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, navigationType)`

Erstellt eine neue Auswahl mit einer Seitennavigationsoption. Auswahlmöglichkeiten, bei denen die Seitennavigation verwendet wird, die im selben Element mit Auswahlmöglichkeiten kombiniert werden, die keine Seitennavigation verwenden.

Parameter

Name	Typ	Beschreibung
`value`	`String`	Wert der Auswahl, der den Befragten beim Ansehen des Formulars als Label angezeigt wird
`navigationType`	`PageNavigationType`	Navigationstyp der Auswahl

Rückflug

Choice — die neue Option

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(response)`

Erstellt eine neue ItemResponse für dieses Multiple-Choice-Element Löst eine Ausnahme aus, wenn das Das Argument response stimmt mit keiner gültigen Auswahl für dieses Element überein, 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 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

MultipleChoiceItem – ein Duplikat von MultipleChoiceItem, 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

`getChoices()`

Ruft alle Auswahlmöglichkeiten für ein Element ab.

Rückflug

Choice[] – eine Reihe von 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 die Befragten sehen, wenn sie eine Frage richtig beantworten.

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

`getFeedbackForIncorrect()`

Gibt das Feedback zurück, das die Befragten sehen, wenn sie eine Frage falsch beantworten.

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

`hasOtherOption()`

Bestimmt, ob das Element „Sonstiges“ hat Option.

Rückflug

Boolean: true, wenn das Element eine andere Bezeichnung hat optional: 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

`setChoiceValues(values)`

Legt die Auswahlmöglichkeiten für ein Element aus einem String-Array fest. Löst eine Ausnahme aus, wenn das angegebene Array ist leer.

// 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[]`	das Array der Auswahlwerte, das die Befragten als Beschriftungen sehen, wenn sie das Formular ansehen

Rückflug

MultipleChoiceItem – diese MultipleChoiceItem, 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 von Auswahlmöglichkeiten für ein Element fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist oder enthält ein null-Element.

// 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[]`	eine Reihe von Auswahlmöglichkeiten

Rückflug

MultipleChoiceItem – diese MultipleChoiceItem, 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 zu erhalten. Bei einem Nullwert wird das Feedback gelöscht.

Rückflug

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

Rückflug

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

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

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

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

MultipleChoiceItem – diese MultipleChoiceItem, 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 „Sonstiges“ hat Option. Der Standardwert für einen neuen CheckboxItem oder MultipleChoiceItem hat den Wert false.

Parameter

Name	Typ	Beschreibung
`enabled`	`Boolean`	`true`, wenn das Element „Sonstiges“ hat optional: `false` wenn nicht

Rückflug

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