Class MultipleChoiceItem

Pytaniejednokrotnegowyboru

Pytanie, które umożliwia respondentowi wybranie jednej opcji z listy przycisków lub opcjonalnego pola „Inne”. Dostęp do elementów można uzyskać lub tworzyć je z poziomu Form. W przypadku użycia w quizie te elementy są oceniane automatycznie. 

// Open a form by ID and add a new multiple choice item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 nowy wybór.
createChoice(value, isCorrect)ChoiceTworzy nowy wybór.
createChoice(value, navigationItem)ChoiceTworzy nowy wybór z opcją nawigacji po stronie, która przenosi do danego elementu podziału strony.
createChoice(value, navigationType)ChoiceTworzy nowy wybór z opcją nawigacji po stronie.
createResponse(response)ItemResponseTworzy nowy ItemResponse dla tego pytania jednokrotnego wyboru.
duplicate()MultipleChoiceItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje elementu.
getFeedbackForCorrect()QuizFeedback|nullZwraca opinię, która jest wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
getFeedbackForIncorrect()QuizFeedback|nullZwraca opinię, która jest wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
getHelpText()StringPobiera tekst pomocy 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 wśród wszystkich elementów w formularzu.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem jest to czasami tekst nagłówka).
getType()ItemTypePobiera typ elementu reprezentowany jako ItemType.
hasOtherOption()BooleanOkreśla, czy element ma opcję „Inne”.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setChoiceValues(values)MultipleChoiceItemUstawia wybory dla elementu z tablicy ciągów znaków.
setChoices(choices)MultipleChoiceItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)MultipleChoiceItemUstawia informację zwrotną, która ma być wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
setFeedbackForIncorrect(feedback)MultipleChoiceItemUstawia opinię, która ma być wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
setHelpText(text)MultipleChoiceItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)MultipleChoiceItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)MultipleChoiceItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)MultipleChoiceItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
showOtherOption(enabled)MultipleChoiceItemOkreśla, czy element ma opcję „Inna odpowiedź”.

Szczegółowa dokumentacja

createChoice(value)

Tworzy nowy wybór.

Parametry

NazwaTypOpis
valueStringwartość wyboru, która jest wyświetlana respondentom jako etykieta podczas przeglądania formularza;

Powrót

Choice – nowy wybór

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

createChoice(value, isCorrect)

Tworzy nowy wybór.

Parametry

NazwaTypOpis
valueStringwartość wyboru, która jest wyświetlana respondentom jako etykieta podczas przeglądania formularza;
isCorrectBooleanczy wybrana odpowiedź jest prawidłowa;

Powrót

Choice – nowy wybór

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

createChoice(value, navigationItem)

Tworzy nowy wybór z opcją nawigacji po stronie, która przenosi do danego elementu podziału strony. Jest to odpowiednik createChoice(value, navigationType) z parametrem navigationType ustawionym na FormApp.PageNavigationType.GO_TO_PAGE. Opcji, które korzystają z nawigacji po stronach, nie można łączyć w tym samym elemencie z opcjami, które nie korzystają z nawigacji po stronach.

Nawigacja po stronie następuje po tym, jak osoba odpowiadająca wypełni stronę zawierającą opcję, i tylko wtedy, gdy wybierze tę opcję. Jeśli respondent wybrał kilka opcji z instrukcjami nawigacji po stronie na tej samej stronie, tylko ostatnia opcja nawigacji ma wpływ na działanie. Nawigacja po stronie nie ma też wpływu na ostatnią stronę formularza.

Parametry

NazwaTypOpis
valueStringwartość wyboru, która jest wyświetlana respondentom jako etykieta podczas przeglądania formularza;
navigationItemPageBreakItemelement, do którego chcesz przejść.

Powrót

Choice – nowy wybór

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

createChoice(value, navigationType)

Tworzy nowy wybór z opcją nawigacji po stronie. Opcji, które korzystają z nawigacji po stronie, nie można łączyć w tym samym elemencie z opcjami, które nie korzystają z nawigacji po stronie.

Nawigacja po stronie następuje po tym, jak osoba odpowiadająca wypełni stronę zawierającą opcję, i tylko wtedy, gdy wybierze tę opcję. Jeśli respondent wybrał kilka opcji z instrukcjami nawigacji po stronie na tej samej stronie, tylko ostatnia opcja nawigacji ma wpływ na działanie. Nawigacja po stronie nie ma też wpływu na ostatnią stronę formularza.

Parametry

NazwaTypOpis
valueStringwartość wyboru, która jest wyświetlana respondentom jako etykieta podczas przeglądania formularza;
navigationTypePageNavigationTypetyp nawigacji wyboru,

Powrót

Choice – nowy wybór

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

createResponse(response)

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

Parametry

NazwaTypOpis
responseStringprawidłową odpowiedź na to pytanie jednokrotnego wyboru.

Powrót

ItemResponse – odpowiedź dotycząca elementu.

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

duplicate()

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

Powrót

MultipleChoiceItem – duplikat tego MultipleChoiceItem do łączenia

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

getChoices()

Pobiera wszystkie opcje elementu.

Powrót

Choice[] – tablica opcji

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

getFeedbackForCorrect()

Zwraca opinię, która jest wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.

Powrót

QuizFeedback|null – opinia, jeśli została dodana.

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

getFeedbackForIncorrect()

Zwraca opinię, która jest wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.

Powrót

QuizFeedback|null – opinia, jeśli została dodana.

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

getHelpText()

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

Powrót

String – tekst pomocy lub opis elementu.

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

getId()

Pobiera unikalny identyfikator elementu.

Powrót

Integer – identyfikator produktu;

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

getIndex()

Pobiera indeks elementu wśród wszystkich elementów w formularzu.

Powrót

Integer – indeks elementu;

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

getPoints()

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

Powrót

Integer – liczba punktów za pytanie.

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

getTitle()

Pobiera tytuł elementu (w przypadku SectionHeaderItem jest to czasami tekst nagłówka).

Powrót

String – tytuł lub tekst nagłówka produktu.

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

getType()

Pobiera typ elementu reprezentowany jako ItemType.

Powrót

ItemType – typ produktu

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

hasOtherOption()

Określa, czy element ma opcję „Inne”.

Powrót

Boolean – true, jeśli element ma opcję „Inne”; false, jeśli nie

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

isRequired()

Określa, czy respondent musi odpowiedzieć na pytanie.

Powrót

Boolean – czy respondent musi odpowiedzieć na pytanie;

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

setChoiceValues(values)

Ustawia wybory dla elementu z tablicy ciągów znaków. Zwraca wyjątek, jeśli podana tablica jest pusta. 

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

Parametry

NazwaTypOpis
valuesString[]tablica wartości do wyboru, które respondenci widzą jako etykiety podczas wyświetlania formularza;

Powrót

MultipleChoiceItem – ten MultipleChoiceItem, do tworzenia łańcuszków

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

setChoices(choices)

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

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

Parametry

NazwaTypOpis
choicesChoice[]tablicę opcji,

Powrót

MultipleChoiceItem – ten MultipleChoiceItem, do tworzenia łańcuszków

Zgłasza

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

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

setFeedbackForCorrect(feedback)

Ustawia informację zwrotną, która ma być wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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
feedbackQuizFeedbacknowe opinie. Wartość null spowoduje usunięcie opinii.

Powrót

MultipleChoiceItem – ten MultipleChoiceItem, do tworzenia łańcuszków

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

setFeedbackForIncorrect(feedback)

Ustawia opinię, która ma być wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowa opinia.

Powrót

MultipleChoiceItem – ten MultipleChoiceItem, do tworzenia łańcuszków

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

setHelpText(text)

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

Parametry

NazwaTypOpis
textStringnowy tekst pomocy,

Powrót

MultipleChoiceItem – ten MultipleChoiceItem, do tworzenia łańcuszków

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

setPoints(points)

Ustawia liczbę punktów, jaką jest warta oceniana pozycja. Wartość domyślna dla nowych elementów to 0.

Parametry

NazwaTypOpis
pointsIntegerliczba punktów, jaką można uzyskać za pytanie.

Powrót

MultipleChoiceItem – ten MultipleChoiceItem, do tworzenia łańcuszków

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

setRequired(enabled)

Określa, czy respondent musi odpowiedzieć na pytanie.

Parametry

NazwaTypOpis
enabledBooleanczy respondent musi odpowiedzieć na pytanie;

Powrót

MultipleChoiceItem – bieżący element (do łączenia);

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

setTitle(title)

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

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka;

Powrót

MultipleChoiceItem – ten MultipleChoiceItem, do tworzenia łańcuszków

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

showOtherOption(enabled)

Określa, czy element ma opcję „Inna odpowiedź”. Domyślna wartość nowego elementu CheckboxItem lub MultipleChoiceItem to false.

Parametry

NazwaTypOpis
enabledBooleantrue jeśli element ma opcję „Inne”; false w przeciwnym razie.

Powrót

MultipleChoiceItem – ten MultipleChoiceItem, do tworzenia łańcuszków

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