Class Choice

Choice

Un seul choix associé à un type de Item compatible avec les choix, comme CheckboxItem, ListItem ou 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(),
  );
}

Méthodes

Méthode	Type renvoyé	Brève description
getGotoPage()	PageBreakItem	Récupère le PageBreakItem défini comme destination GO_TO_PAGE si le répondant sélectionne cette option et termine la page en cours.
getPageNavigationType()	PageNavigationType	Récupère l'PageNavigationType qui se produit si le répondant sélectionne cette option et termine la page en cours.
getValue()	String	Récupère la valeur de l'option, qui s'affiche sous forme de libellé pour les personnes interrogées lorsqu'elles consultent le formulaire.
isCorrectAnswer()	Boolean	Indique si le choix est une réponse correcte à la question.

Documentation détaillée

getGotoPage()

Récupère le PageBreakItem défini comme destination GO_TO_PAGE si le répondant sélectionne cette option et termine la page en cours. Cette méthode ne s'applique qu'aux choix associés à MultipleChoiceItems. Pour les autres choix, elle renvoie null.

Renvois

PageBreakItem : destination GO_TO_PAGE de ce choix, ou null s'il n'y en a pas

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

---

getPageNavigationType()

Récupère l'PageNavigationType qui se produit si le répondant sélectionne cette option et termine la page en cours. Cette méthode ne s'applique qu'aux choix associés à MultipleChoiceItems. Pour les autres choix, elle renvoie null.

Renvois

PageNavigationType : action de navigation pour ce choix, ou null s'il n'y en a pas

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

---

getValue()

Récupère la valeur de l'option, qui s'affiche sous forme de libellé pour les personnes interrogées lorsqu'elles consultent le formulaire.

Renvois

String : valeur du choix

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

---

isCorrectAnswer()

Indique si le choix est une réponse correcte à la question. Cette méthode ne s'applique qu'aux questions qui font partie d'un quiz. Pour les formulaires autres que des quiz, elle renvoie la valeur "false".

Renvois

Boolean : indique si la réponse est correcte.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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