Class MultipleChoiceItem

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
MultipleChoiceItem

Ein Fragenelement, bei dem der Teilnehmer aus einer Liste von Optionsfeldern oder einem optionalen Feld „Sonstiges“ eine Antwort auswählen kann. 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 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

MethodeRückgabetypKurzbeschreibung
createChoice(value)ChoiceErstellt eine neue Auswahl.
createChoice(value, isCorrect)ChoiceErstellt eine neue Auswahl.
createChoice(value, navigationItem)ChoiceErstellt eine neue Auswahl mit einer Seitennavigationsoption, mit der zu einem bestimmten Seitenumbruch gewechselt wird.
createChoice(value, navigationType)ChoiceErstellt eine neue Auswahl mit einer Seitennavigationsoption.
createResponse(response)ItemResponseErstellt eine neue ItemResponse für dieses Multiple-Choice-Element.
duplicate()MultipleChoiceItemErstellt 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()QuizFeedbackGibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine Frage richtig beantworten.
getFeedbackForIncorrect()QuizFeedbackGibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie falsch auf eine Frage antworten.
getHelpText()StringRuft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet.
getId()IntegerRuft die eindeutige Kennung des Elements ab.
getIndex()IntegerRuft den Index des Elements aus allen Elementen im Formular ab.
getPoints()IntegerGibt die Punktzahl eines benotebaren Elements zurück.
getTitle()StringRuft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem.
getType()ItemTypeRuft den Elementtyp ab, dargestellt als ItemType.
hasOtherOption()BooleanLegt fest, ob das Element die Option „Sonstiges“ hat.
isRequired()BooleanLegt fest, ob der Teilnehmer die Frage beantworten muss.
setChoiceValues(values)MultipleChoiceItemLegt die Auswahl für ein Element aus einem String-Array fest.
setChoices(choices)MultipleChoiceItemLegt ein Array von Auswahlmöglichkeiten für ein Element fest.
setFeedbackForCorrect(feedback)MultipleChoiceItemLegt fest, dass das Feedback den Teilnehmern angezeigt werden soll, wenn sie eine Frage richtig beantworten.
setFeedbackForIncorrect(feedback)MultipleChoiceItemSie können festlegen, dass Feedback den Teilnehmern angezeigt werden soll, wenn sie falsch auf eine Frage antworten.
setHelpText(text)MultipleChoiceItemLegt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems).
setPoints(points)MultipleChoiceItemLegt die Anzahl der Punkte fest, die ein Element in einer Benotung wert ist.
setRequired(enabled)MultipleChoiceItemLegt fest, ob der Teilnehmer die Frage beantworten muss.
setTitle(title)MultipleChoiceItemLegt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem)
showOtherOption(enabled)MultipleChoiceItemLegt fest, ob das Element die Option „Sonstiges“ hat.

Detaillierte Dokumentation

createChoice(value)

Erstellt eine neue Auswahl.

Parameter

NameTypBeschreibung
valueStringDer 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

NameTypBeschreibung
valueStringDer Wert der Auswahl, den Teilnehmer beim Ansehen des Formulars als Label sehen
isCorrectBooleanob 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

createChoice(value, navigationItem)

Erstellt eine neue Auswahl mit einer Seitennavigationsoption, mit der zu einem bestimmten Seitenumbruch gewechselt wird. Dies entspricht createChoice(value, navigationType), wobei navigationType auf FormApp.PageNavigationType.GO_TO_PAGE gesetzt ist. Auswahlmöglichkeiten, die die Seitennavigation verwenden, können nicht im selben Element mit Optionen kombiniert werden, die keine Seitennavigation verwenden.

Die Seitennavigation erfolgt, nachdem der Befragte eine Seite mit der Option abgeschlossen hat und der Befragte diese Option ausgewählt hat. Hat der Teilnehmer mehrere Optionen mit Anleitung für die Seitennavigation auf derselben Seite ausgewählt, hat nur die letzte Navigationsoption Auswirkungen. Die Seitennavigation wirkt sich auch nicht auf die letzte Seite eines Formulars aus.

Parameter

NameTypBeschreibung
valueStringDer Wert der Auswahl, den Teilnehmer beim Ansehen des Formulars als Label sehen
navigationItemPageBreakItemdas Element, zu dem navigiert werden soll

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

Erstellt eine neue Auswahl mit einer Seitennavigationsoption. Auswahlmöglichkeiten, die die Seitennavigation verwenden, können nicht im selben Element mit Auswahlmöglichkeiten ohne Seitennavigation kombiniert werden.

Die Seitennavigation erfolgt, nachdem der Befragte eine Seite mit der Option abgeschlossen hat und der Befragte diese Option ausgewählt hat. Hat der Teilnehmer mehrere Optionen mit Anleitung für die Seitennavigation auf derselben Seite ausgewählt, hat nur die letzte Navigationsoption Auswirkungen. Die Seitennavigation wirkt sich auch nicht auf die letzte Seite eines Formulars aus.

Parameter

NameTypBeschreibung
valueStringDer Wert der Auswahl, den Teilnehmer beim Ansehen des Formulars als Label sehen
navigationTypePageNavigationTypeNavigationstyp der Wahl

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

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

Parameter

NameTypBeschreibung
responseStringeine gültige Antwort auf diesen Multiple-Choice-Artikel

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

MultipleChoiceItem: ein Duplikat dieses MultipleChoiceItem, 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

NameTypBeschreibung
valuesString[]Array mit Auswahlwerten, die den Umfrageteilnehmern beim Ansehen des Formulars als Labels angezeigt werden

Zurücksenden

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

NameTypBeschreibung
choicesChoice[]ein Array von Auswahlmöglichkeiten

Zurücksenden

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

NameTypBeschreibung
feedbackQuizFeedbackdas neue Feedback. Bei einem Wert von null wird das Feedback gelöscht.

Zurücksenden

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

NameTypBeschreibung
feedbackQuizFeedbackdas neue Feedback

Zurücksenden

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

NameTypBeschreibung
textStringden neuen Hilfetext

Zurücksenden

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

NameTypBeschreibung
pointsIntegerdie Anzahl der Punkte, die ein Frageartikel wert ist

Zurücksenden

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

NameTypBeschreibung
enabledBooleanob der Teilnehmer die Frage beantworten muss

Zurücksenden

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

NameTypBeschreibung
titleStringden neuen Titel oder Titel

Zurücksenden

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

NameTypBeschreibung
enabledBooleantrue, wenn der Artikel die Option „Sonstiges“ hat; false, wenn nicht

Zurücksenden

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