Class MultipleChoiceItem

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

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, die zu einem bestimmten Element für den Seitenumbruch springt.
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 sie am Ende des Formulars an.
getChoices()Choice[]Ruft alle Auswahlmöglichkeiten für ein Element ab.
getFeedbackForCorrect()QuizFeedbackGibt das Feedback zurück, das die Befragten sehen, wenn sie eine Frage richtig beantworten.
getFeedbackForIncorrect()QuizFeedbackGibt das Feedback zurück, das die Befragten sehen, wenn sie eine Frage falsch beantworten.
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 Kennzeichnung des Artikels ab.
getIndex()IntegerRuft den Index des Elements unter allen Elementen im Formular ab.
getPoints()IntegerGibt die Punktzahl eines benoteten Elements zurück
getTitle()StringRuft den Titel des Elements ab. Wird manchmal als Überschrifttext bezeichnet, im Fall von SectionHeaderItem.
getType()ItemTypeRuft den Typ des Elements ab, dargestellt als ItemType.
hasOtherOption()BooleanBestimmt, ob das Element „Sonstiges“ hat Option.
isRequired()BooleanBestimmt, ob der Teilnehmer die Frage beantworten muss.
setChoiceValues(values)MultipleChoiceItemLegt die Auswahlmöglichkeiten 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 Befragten angezeigt wird, wenn sie eine Frage richtig beantworten.
setFeedbackForIncorrect(feedback)MultipleChoiceItemLegt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten.
setHelpText(text)MultipleChoiceItemLegt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
setPoints(points)MultipleChoiceItemLegt die Anzahl der Punkte fest, die ein benotetes Element wert ist.
setRequired(enabled)MultipleChoiceItemLegt fest, ob der Befragte die Frage beantworten muss.
setTitle(title)MultipleChoiceItemLegt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem).
showOtherOption(enabled)MultipleChoiceItemLegt fest, ob das Element „Sonstiges“ hat Option.

Detaillierte Dokumentation

createChoice(value)

Erstellt eine neue Auswahl.

Parameter

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

NameTypBeschreibung
valueStringWert der Auswahl, der den Befragten beim Ansehen des Formulars als Label angezeigt wird
isCorrectBooleanob 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

NameTypBeschreibung
valueStringWert der Auswahl, der den Befragten beim Ansehen des Formulars als Label angezeigt wird
navigationItemPageBreakItemdas 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.

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

NameTypBeschreibung
valueStringWert der Auswahl, der den Befragten beim Ansehen des Formulars als Label angezeigt wird
navigationTypePageNavigationTypeNavigationstyp 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

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

NameTypBeschreibung
valuesString[]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

NameTypBeschreibung
choicesChoice[]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

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

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

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

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

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

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

NameTypBeschreibung
enabledBooleantrue, 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