Class MultipleChoiceItem

MultipleChoiceItem

Element pytania, który umożliwia respondentowi wybranie jednej opcji z listy przycisków lub opcjonalnego pola „inne”. Elementy można otworzyć lub utworzyć za pomocą: Form. W quizie są one oceniane automatycznie.

// Open a form by ID and add a new multiple choice item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats'),
        item.createChoice('Dogs')
     ])
    .showOtherOption(true);

Metody

MetodaZwracany typKrótki opis
createChoice(value)ChoiceTworzy nową opcję wyboru.
createChoice(value, isCorrect)ChoiceTworzy nową opcję wyboru.
createChoice(value, navigationItem)ChoiceTworzy nową opcję z opcją nawigacji, która przechodzi do konkretnego elementu podziału strony.
createChoice(value, navigationType)ChoiceTworzy nową opcję z opcją nawigacji po stronie.
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tego produktu wielokrotnego wyboru.
duplicate()MultipleChoiceItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje dotyczące elementu.
getFeedbackForCorrect()QuizFeedbackZwraca komentarz wyświetlany użytkownikom, którzy odpowiedzą prawidłowo na pytanie.
getFeedbackForIncorrect()QuizFeedbackZwraca informacje zwrotne, które są wyświetlane użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.
getHelpText()StringPobiera tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
hasOtherOption()BooleanOkreśla, czy dla elementu jest dostępna opcja „inne”.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setChoiceValues(values)MultipleChoiceItemUstawia opcje elementu z tablicy ciągów tekstowych.
setChoices(choices)MultipleChoiceItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)MultipleChoiceItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiedzą na pytanie poprawnie.
setFeedbackForIncorrect(feedback)MultipleChoiceItemOkreśla komentarz, który będzie wyświetlany użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.
setHelpText(text)MultipleChoiceItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)MultipleChoiceItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)MultipleChoiceItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)MultipleChoiceItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
showOtherOption(enabled)MultipleChoiceItemOkreśla, czy dla elementu jest dostępna opcja „inne”.

Szczegółowa dokumentacja

createChoice(value)

Tworzy nową opcję wyboru.

Parametry

NazwaTypOpis
valueStringwartości wyboru, którą ankietowani widzą jako etykietę podczas wyświetlania formularza.

Powroty

Choice – nowa opcja

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

createChoice(value, isCorrect)

Tworzy nową opcję wyboru.

Parametry

NazwaTypOpis
valueStringwartości wyboru, którą ankietowani widzą jako etykietę podczas wyświetlania formularza.
isCorrectBooleanczy wybrana odpowiedź jest poprawna,

Powroty

Choice – nowa opcja

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

createChoice(value, navigationItem)

Tworzy nową opcję z opcją nawigacji, która przechodzi do konkretnego elementu podziału strony. Jest to odpowiednik funkcji createChoice(value, navigationType) z parametrem navigationType ustawionym na FormApp.PageNavigationType.GO_TO_PAGE. Wyborów służących do nawigacji po stronie nie można łączyć w jednym elemencie z opcjami, które nie korzystają z nawigacji po stronie.

Nawigacja na stronie ma miejsce po wypełnieniu strony, na której znajduje się dana opcja, i tylko wtedy, gdy użytkownik ją wybrał. Jeśli respondent wybrał wiele opcji z instrukcjami nawigacji na stronie na tej samej stronie, efektem będzie tylko ostatnia opcja nawigacji. Nawigacja na stronie nie ma też wpływu na ostatnią stronę formularza.

Parametry

NazwaTypOpis
valueStringwartości wyboru, którą ankietowani widzą jako etykietę podczas wyświetlania formularza.
navigationItemPageBreakItemelement, do którego chcesz przejść

Powroty

Choice – nowa opcja

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

createChoice(value, navigationType)

Tworzy nową opcję z opcją nawigacji po stronie. Wyborów dotyczących nawigacji na stronie nie można łączyć w ramach tego samego elementu z opcjami, które nie korzystają z nawigacji po stronie.

Nawigacja na stronie ma miejsce po wypełnieniu strony, na której znajduje się dana opcja, i tylko wtedy, gdy użytkownik ją wybrał. Jeśli respondent wybrał wiele opcji z instrukcjami nawigacji na stronie na tej samej stronie, efektem będzie tylko ostatnia opcja nawigacji. Nawigacja na stronie nie ma też wpływu na ostatnią stronę formularza.

Parametry

NazwaTypOpis
valueStringwartości wyboru, którą ankietowani widzą jako etykietę podczas wyświetlania formularza.
navigationTypePageNavigationTypetyp nawigacji dla opcji wyboru

Powroty

Choice – nowa opcja

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

createResponse(response)

Tworzy nowy element ItemResponse dla tego produktu wielokrotnego wyboru. Zwraca wyjątek, jeśli argument response nie pasuje do prawidłowej opcji dla tego elementu, chyba że showOtherOption(enabled) ma wartość true.

Parametry

NazwaTypOpis
responseStringpoprawna odpowiedź dotycząca tego elementu wielokrotnego wyboru

Powroty

ItemResponse – odpowiedź dotycząca produktu,

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

duplicate()

Tworzy kopię tego elementu i dołącza ją na końcu formularza.

Powroty

MultipleChoiceItem – duplikat elementu MultipleChoiceItem na potrzeby łańcuchów

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

getChoices()

Pobiera wszystkie opcje dotyczące elementu.

Powroty

Choice[] – tablica dostępnych opcji.

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

getFeedbackForCorrect()

Zwraca komentarz wyświetlany użytkownikom, którzy odpowiedzą prawidłowo na pytanie.

Powroty

QuizFeedback – ewentualna opinia.

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

getFeedbackForIncorrect()

Zwraca informacje zwrotne, które są wyświetlane użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.

Powroty

QuizFeedback – ewentualna opinia.

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

getHelpText()

Pobiera tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powroty

String – tekst pomocy lub opis dotyczący produktu.

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

getId()

Pobiera unikalny identyfikator elementu.

Powroty

Integer – identyfikator produktu,

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

getIndex()

Pobiera indeks elementu spośród wszystkich elementów formularza.

Powroty

Integer – indeks elementu;

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

getPoints()

Zwraca wartość punktową elementu podlegającego ocenie.

Powroty

Integer – liczba punktów, za jaką pytanie jest warte pytanie.

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

getTitle()

Pobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

Powroty

String – tytuł lub tekst nagłówka elementu;

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

getType()

Pobiera typ elementu, reprezentowany jako ItemType.

Powroty

ItemType – typ elementu;

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

hasOtherOption()

Określa, czy dla elementu jest dostępna opcja „inne”.

Powroty

Booleantrue, jeśli element ma opcję „inne”, lub false, jeśli nie jest dostępna

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

isRequired()

Określa, czy użytkownik musi odpowiedzieć na pytanie.

Powroty

Boolean – czy użytkownik musi odpowiedzieć na pytanie;

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

setChoiceValues(values)

Ustawia opcje elementu z tablicy ciągów tekstowych. Zgłasza wyjątek, jeśli podana tablica jest pusta.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parametry

NazwaTypOpis
valuesString[]w tablicy wartości wyboru, które użytkownicy widzą jako etykiety podczas wyświetlania formularza.

Powroty

MultipleChoiceItem – ten MultipleChoiceItem, do łańcuchów

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

setChoices(choices)

Ustawia tablicę opcji dla elementu. Zgłasza wyjątek, jeśli podana tablica jest pusta lub zawiera element null.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

Parametry

NazwaTypOpis
choicesChoice[]szeroki wybór opcji

Powroty

MultipleChoiceItem – ten MultipleChoiceItem, do łańcuchów

Rzuty

Error – jeśli tablica jest null, jest pusta lub zawiera element null

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

setFeedbackForCorrect(feedback)

Określa informacje, które będą wyświetlane respondentom, gdy odpowiedzą na pytanie poprawnie.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowych informacji zwrotnych. Wartość null spowoduje wyczyszczenie opinii.

Powroty

MultipleChoiceItem – ten MultipleChoiceItem, do łańcuchów

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

setFeedbackForIncorrect(feedback)

Określa komentarz, który będzie wyświetlany użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowa opinia

Powroty

MultipleChoiceItem – ten MultipleChoiceItem, do łańcuchów

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

setHelpText(text)

Ustawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

NazwaTypOpis
textStringnowy tekst pomocy

Powroty

MultipleChoiceItem – ten MultipleChoiceItem, do łańcuchów

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

setPoints(points)

Określa liczbę punktów za element, który można ocenić. Wartość domyślna nowych elementów to 0.

Parametry

NazwaTypOpis
pointsIntegerliczba punktów wartych pytania

Powroty

MultipleChoiceItem – ten MultipleChoiceItem, do łańcuchów

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

setRequired(enabled)

Określa, czy użytkownik musi odpowiedzieć na pytanie.

Parametry

NazwaTypOpis
enabledBooleanczy respondent musi odpowiedzieć na pytanie,

Powroty

MultipleChoiceItem – bieżący element (na potrzeby łańcuszków)

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

setTitle(title)

Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka.

Powroty

MultipleChoiceItem – ten MultipleChoiceItem, do łańcuchów

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

showOtherOption(enabled)

Określa, czy dla elementu jest dostępna opcja „inne”. Wartością domyślną CheckboxItem lub MultipleChoiceItem jest false.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli element ma opcję „inne”, lub „false” w przeciwnym razie

Powroty

MultipleChoiceItem – ten MultipleChoiceItem, do łańcuchów

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