Class Choice

Wybór

Jedna opcja powiązana z typem Item, który obsługuje opcje takie jak CheckboxItem, ListItem lub MultipleChoiceItem.

// Create a new form and add a multiple-choice item.
var form = FormApp.create('Form Name');
var 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.
var choices = item.getChoices();
for (var 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 obiekt PageBreakItem ustawiony jako miejsce docelowe GO_TO_PAGE, jeśli ankietowany wybierze tę opcję i uzupełni bieżącą stronę.
getPageNavigationType()PageNavigationTypePobiera parametr PageNavigationType, który pojawia się, gdy ankietowany wybierze tę opcję i ukończy bieżącą stronę.
getValue()StringPobiera wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza.
isCorrectAnswer()BooleanSprawdza, czy wybrana odpowiedź jest prawidłową odpowiedzią na pytanie.

Szczegółowa dokumentacja

getGotoPage()

Pobiera obiekt PageBreakItem ustawiony jako miejsce docelowe GO_TO_PAGE, jeśli ankietowany wybierze tę opcję i uzupełni bieżącą stronę. Ta metoda dotyczy tylko opcji powiązanych z właściwością MultipleChoiceItems, a w przypadku innych opcji zwraca wartość null.

Powroty

PageBreakItem – miejsce docelowe GO_TO_PAGE dla tej opcji lub null, jeśli ich nie ma.

Upoważnienie

Skrypty korzystające 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 parametr PageNavigationType, który pojawia się, gdy ankietowany wybierze tę opcję i ukończy bieżącą stronę. Ta metoda ma zastosowanie tylko do opcji powiązanych z właściwością MultipleChoiceItems. W przypadku innych opcji zwraca wartość null.

Powroty

PageNavigationType – działanie nawigacyjne związane z tą opcją lub null, jeśli ich nie ma.

Upoważnienie

Skrypty korzystające 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órą respondenci widzą jako etykietę podczas wyświetlania formularza.

Powroty

String – wartość wyboru;

Upoważnienie

Skrypty korzystające 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()

Sprawdza, czy wybrana odpowiedź jest prawidłową odpowiedzią na pytanie. Ta metoda ma zastosowanie tylko do pytań, które wchodzą w skład testu. W przypadku formularzy innych niż test zwraca wartość „false” (fałsz).

Powroty

Boolean – wskazuje, czy odpowiedź jest poprawna.

Upoważnienie

Skrypty korzystające 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