Class Choice

Choice

Eine einzelne Auswahl, die mit einem Item-Typ verknüpft 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

Methode	Rückgabetyp	Kurzbeschreibung
getGotoPage()	PageBreakItem	Der PageBreakItem wird als GO_TO_PAGE-Ziel festgelegt, wenn der Teilnehmer diese Option auswählt und die aktuelle Seite abschließt.
getPageNavigationType()	PageNavigationType	Ruft die PageNavigationType ab, die auftritt, wenn der Teilnehmer diese Option auswählt und die aktuelle Seite abschließt.
getValue()	String	Der Wert der Auswahl, der den Teilnehmern im Formular als Label angezeigt wird.
isCorrectAnswer()	Boolean	Gibt an, ob die Auswahl eine richtige Antwort auf die Frage ist.

Detaillierte Dokumentation

getGotoPage()

Der PageBreakItem wird als GO_TO_PAGE-Ziel festgelegt, wenn der Teilnehmer diese Option auswählt und die aktuelle Seite abschließt. Diese Methode gilt nur für Optionen, die mit MultipleChoiceItems verknüpft sind. Bei anderen Optionen 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getPageNavigationType()

Ruft die PageNavigationType ab, die auftritt, wenn der Teilnehmer diese Option auswählt und die aktuelle Seite abschließt. Diese Methode gilt nur für Optionen, die mit MultipleChoiceItems verknüpft sind. Bei anderen Optionen 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getValue()

Der Wert der Auswahl, der den Teilnehmern im Formular als Label angezeigt wird.

Rückflug

String: Wert der Auswahl

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

• 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. Bei anderen Formularen wird „falsch“ zurückgegeben.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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