Class Choice

Choice

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()PageBreakItemPobiera wartość PageBreakItem ustawioną jako miejsce docelowe GO_TO_PAGE, jeśli osoba wypełniająca formularz wybierze tę opcję i zamknie bieżącą stronę.
getPageNavigationType()PageNavigationTypePobiera wartość PageNavigationType, która występuje, gdy respondent wybierze tę opcję i zamknie bieżącą stronę.
getValue()StringPobiera wartość wyboru, która jest widoczna dla respondentów jako etykieta podczas wyświetlania formularza.
isCorrectAnswer()BooleanOkreśla, czy wybrana odpowiedź jest poprawna.

Szczegółowa dokumentacja

getGotoPage()

Pobiera wartość PageBreakItem ustawioną jako miejsce docelowe GO_TO_PAGE, jeśli osoba wypełniająca formularz wybierze tę opcję i zamknie bieżącą stronę. Ta metoda dotyczy tylko wyborów powiązanych z wartością MultipleChoiceItems. W przypadku innych wyborów zwraca wartość null.

Powrót

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

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getPageNavigationType()

Pobiera wartość PageNavigationType, która występuje, gdy respondent wybierze tę opcję i zamknie bieżącą stronę. Ta metoda dotyczy tylko wyborów powiązanych z wartością MultipleChoiceItems. W przypadku innych wyborów zwraca wartość null.

Powrót

PageNavigationType – działanie nawigacyjne związane z tym wyborem lub null, jeśli nie ma takiego działania.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getValue()

Pobiera wartość wyboru, która jest widoczna dla respondentów jako etykieta podczas wyświetlania formularza.

Powrót

String – wartość wyboru

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

isCorrectAnswer()

Określa, czy wybrana odpowiedź jest poprawna. Ta metoda dotyczy tylko pytań, które są częścią testu. W przypadku formularzy innych niż testy zwraca wartość false.

Powrót

Boolean – czy wybrana odpowiedź jest poprawna.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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