Class Choice

Choice

Eine einzelne Auswahl, die einem Typ von Item zugeordnet ist, der Auswahlmöglichkeiten unterstützt, z. B. CheckboxItem, ListItem oder MultipleChoiceItem. 

// Create a new form and add a multiple-choice item.
const form = FormApp.create('Form Name');
const 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.
const choices = item.getChoices();
for (let 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 die PageBreakItem ab, die als GO_TO_PAGE-Ziel festgelegt ist, wenn der Antwortende diese Option auswählt und die aktuelle Seite abschließt.
getPageNavigationType()PageNavigationTypeGibt die PageNavigationType zurück, die auftritt, wenn der Antwortende diese Option auswählt und die aktuelle Seite abschließt.
getValue()StringRuft den Wert der Auswahl ab, der den Teilnehmern als Label angezeigt wird, wenn sie das Formular aufrufen.
isCorrectAnswer()BooleanRuft ab, ob die Auswahl eine richtige Antwort auf die Frage ist.

Detaillierte Dokumentation

getGotoPage()

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

Rückflug

PageBreakItem – das GO_TO_PAGE-Ziel für diese Auswahl oder null, falls keines vorhanden ist

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getPageNavigationType()

Gibt die PageNavigationType zurück, die auftritt, wenn der Antwortende diese Option auswählt und die aktuelle Seite abschließt. Diese Methode gilt nur für Entscheidungen, die mit MultipleChoiceItems verknüpft sind. Für andere Entscheidungen wird null zurückgegeben.

Rückflug

PageNavigationType – die Navigationsaktion für diese Auswahl oder null, falls keine vorhanden ist

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getValue()

Ruft den Wert der Auswahl ab, der den Teilnehmern als Label angezeigt wird, wenn sie das Formular aufrufen.

Rückflug

String: Der Wert der Auswahl.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

isCorrectAnswer()

Gibt an, ob die Auswahl eine 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.

Rückflug

Boolean – Gibt an, ob die Auswahl eine richtige Antwort ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms