Class Choice

Auswahl

Eine einzelne Auswahl, die mit einem Item-Typ verknüpft ist, der Auswahlmöglichkeiten wie CheckboxItem, ListItem oder MultipleChoiceItem unterstützt.

// Create a new form and add a multiple-choice item.
var form = FormApp.create('Form Name');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats', FormApp.PageNavigationType.CONTINUE),
        item.createChoice('Dogs', FormApp.PageNavigationType.RESTART)
    ]);

// Add another page because navigation has no effect on the last page.
form.addPageBreakItem().setTitle('You chose well!');

// Log the navigation types that each choice results in.
var choices = item.getChoices();
for (var i = 0; i < choices.length; i++) {
Logger.log('If the respondent chooses "%s", the form will %s.',
           choices[i].getValue(),
           choices[i].getPageNavigationType());
}

Methoden

MethodeRückgabetypKurzbeschreibung
getGotoPage()PageBreakItemRuft das PageBreakItem-Objekt ab, das als GO_TO_PAGE-Ziel festgelegt ist, wenn der Bereitsteller diese Auswahl auswählt und die aktuelle Seite abschließt.
getPageNavigationType()PageNavigationTypeRuft das PageNavigationType ab, das auftritt, wenn der Teilnehmer diese Auswahl auswählt und die aktuelle Seite abschließt.
getValue()StringRuft den Wert der Auswahl ab, den die Befragten als Label sehen, wenn sie das Formular anzeigen.
isCorrectAnswer()BooleanErmittelt, ob die Antwort die richtige Antwort auf die Frage ist.

Detaillierte Dokumentation

getGotoPage()

Ruft das PageBreakItem-Objekt ab, das als GO_TO_PAGE-Ziel festgelegt ist, wenn der Bereitsteller diese Auswahl auswählt und die aktuelle Seite abschließt. Diese Methode gilt nur für Auswahlmöglichkeiten, die mit MultipleChoiceItems verknüpft sind. Für andere Auswahlmöglichkeiten wird null zurückgegeben.

Return

PageBreakItem: das GO_TO_PAGE-Ziel für diese Auswahl oder null, wenn keines angegeben 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

getPageNavigationType()

Ruft das PageNavigationType ab, das auftritt, wenn der Teilnehmer diese Auswahl auswählt und die aktuelle Seite abschließt. Diese Methode gilt nur für Auswahlmöglichkeiten, die mit MultipleChoiceItems verknüpft sind. Für andere Auswahlmöglichkeiten wird null zurückgegeben.

Return

PageNavigationType: die Navigationsaktion für diese Auswahl oder null, wenn keine Aktion vorhanden 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

getValue()

Ruft den Wert der Auswahl ab, den die Befragten als Label sehen, wenn sie das Formular anzeigen.

Return

String: Wert der Auswahl

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

isCorrectAnswer()

Ermittelt, ob die Antwort die richtige Antwort auf die Frage ist. Diese Methode gilt nur für Fragen, die Teil eines Quiz sind. Für andere Formulare wird „false“ zurückgegeben.

Return

Boolean: Gibt an, ob die Antwort richtig 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