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

MethodeRückgabetypKurzbeschreibung
getGotoPage()PageBreakItemDer PageBreakItem wird als GO_TO_PAGE-Ziel festgelegt, wenn der Teilnehmer diese Option auswählt und die aktuelle Seite abschließt.
getPageNavigationType()PageNavigationTypeRuft die PageNavigationType ab, die auftritt, wenn der Teilnehmer diese Option auswählt und die aktuelle Seite abschließt.
getValue()StringDer Wert der Auswahl, der den Teilnehmern im Formular als Label angezeigt wird.
isCorrectAnswer()BooleanGibt 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