Class Choice

Wybór

Pojedynczy wybór powiązany z typem Item, który obsługuje wybory, np. CheckboxItem, ListItem lub 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(),
  );
}

Metody

MetodaZwracany typKrótki opis
getGotoPage()PageBreakItemUstawia PageBreakItem jako GO_TO_PAGE miejsce docelowe, jeśli osoba odpowiadająca wybierze tę opcję i wypełni bieżącą stronę.
getPageNavigationType()PageNavigationTypeZwraca wartość PageNavigationType, która występuje, jeśli osoba odpowiadająca wybierze tę opcję i wypełni bieżącą stronę.
getValue()StringPobiera wartość wyboru, która jest wyświetlana respondentom jako etykieta podczas przeglądania formularza.
isCorrectAnswer()BooleanSprawdza, czy wybrana odpowiedź jest prawidłowa.

Szczegółowa dokumentacja

getGotoPage()

Ustawia PageBreakItem jako GO_TO_PAGE miejsce docelowe, jeśli odpowiadający wybierze tę opcję i wypełni bieżącą stronę. Ta metoda ma zastosowanie tylko do wyborów powiązanych z MultipleChoiceItems. W przypadku innych wyborów zwraca wartość null.

Powrót

PageBreakItem – GO_TO_PAGE miejsce docelowe dla tego wyboru lub null, jeśli nie ma takiego miejsca.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getPageNavigationType()

Zwraca wartość PageNavigationType, która występuje, jeśli osoba odpowiadająca wybierze tę opcję i wypełni bieżącą stronę. Ta metoda dotyczy tylko wyborów powiązanych z MultipleChoiceItems. W przypadku innych wyborów zwraca wartość null.

Powrót

PageNavigationType – działanie nawigacyjne dla tego wyboru lub null, jeśli nie ma takiego działania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getValue()

Pobiera wartość wyboru, która jest wyświetlana respondentom jako etykieta podczas przeglądania formularza.

Powrót

String – wartość wyboru.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

isCorrectAnswer()

Sprawdza, czy wybrana odpowiedź jest prawidłowa. Ta metoda dotyczy tylko pytań, które są częścią testu. W przypadku formularzy, które nie są testami, zwraca wartość false.

Powrót

Boolean – czy wybrana odpowiedź jest poprawna.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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