Class MultipleChoiceItem

Pytaniejednokrotnegowyboru

Element pytania, który umożliwia respondentowi wybranie jednej opcji z listy przycisków opcji lub opcjonalnego pola „inne”. Elementy można tworzyć i otwierać w ramach Form. Gdy są używane w teście, są automatycznie oceniane.

// 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

Metoda	Zwracany typ	Krótki opis
createChoice(value)	Choice	Tworzy nowy wybór.
createChoice(value, isCorrect)	Choice	Tworzy nowy wybór.
createChoice(value, navigationItem)	Choice	Tworzy nowy wybór z opcją nawigacji po stronie, która przenosi do danego elementu z podziałem na strony.
createChoice(value, navigationType)	Choice	Tworzy nowy wybór z opcją nawigacji po stronie.
createResponse(response)	ItemResponse	Tworzy nowy element ItemResponse dla tego elementu z wieloma odpowiedziami.
duplicate()	MultipleChoiceItem	Tworzy kopię tego elementu i dodaje ją na końcu formularza.
getChoices()	Choice[]	Pobiera wszystkie opcje dotyczące danego elementu.
getFeedbackForCorrect()	QuizFeedback	Zwraca opinię, która jest wyświetlana respondentom po udzieleniu przez nich prawidłowej odpowiedzi na pytanie.
getFeedbackForIncorrect()	QuizFeedback	Zwraca opinię, która jest wyświetlana respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
getHelpText()	String	Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()	Integer	Pobiera unikalny identyfikator produktu.
getIndex()	Integer	Pobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()	Integer	Zwraca liczbę punktów za element, który można ocenić.
getTitle()	String	Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
getType()	ItemType	Pobiera typ elementu jako ItemType.
hasOtherOption()	Boolean	Określa, czy element ma opcję „Inne”.
isRequired()	Boolean	Określa, czy respondent musi odpowiedzieć na pytanie.
setChoiceValues(values)	MultipleChoiceItem	Ustawia opcje elementu na podstawie tablicy ciągów znaków.
setChoices(choices)	MultipleChoiceItem	Określa tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)	MultipleChoiceItem	Określa opinię, która ma być wyświetlana respondentom, gdy udzielą prawidłowej odpowiedzi na pytanie.
setFeedbackForIncorrect(feedback)	MultipleChoiceItem	Określa komentarz, który ma być wyświetlany respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
setHelpText(text)	MultipleChoiceItem	Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)	MultipleChoiceItem	Określa liczbę punktów, które można przyznać ocenianemu elementowi.
setRequired(enabled)	MultipleChoiceItem	Określa, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)	MultipleChoiceItem	Ustawia tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
showOtherOption(enabled)	MultipleChoiceItem	Określa, czy element ma opcję „Inne”.

Szczegółowa dokumentacja

createChoice(value)

Tworzy nowy wybór.

Parametry

Nazwa	Typ	Opis
value	String	wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza.

Powrót

Choice – nowy wybór

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

---

createChoice(value, isCorrect)

Tworzy nowy wybór.

Parametry

Nazwa	Typ	Opis
value	String	wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza.
isCorrect	Boolean	czy wybrana odpowiedź jest poprawna.

Powrót

Choice – nowy wybór

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

---

createChoice(value, navigationItem)

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

Nawigacja po stronach następuje po wypełnieniu przez respondenta strony zawierającej opcję i tylko wtedy, gdy respondent wybrał tę opcję. Jeśli respondent wybrał kilka opcji z instrukcjami nawigacji po stronie, ma to wpływ tylko na ostatnią opcję nawigacji. Nawigacja po stronach nie ma też wpływu na ostatnią stronę formularza.

Parametry

Nazwa	Typ	Opis
value	String	wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza.
navigationItem	PageBreakItem	element, do którego chcesz przejść.

Powrót

Choice – nowy wybór

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

---

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 stronach następuje po wypełnieniu przez respondenta strony zawierającej opcję i tylko wtedy, gdy respondent wybrał tę opcję. Jeśli respondent wybrał kilka opcji z instrukcjami nawigacji po stronie, ma to wpływ tylko na ostatnią opcję nawigacji. Nawigacja po stronach nie ma też wpływu na ostatnią stronę formularza.

Parametry

Nazwa	Typ	Opis
value	String	wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza.
navigationType	PageNavigationType	typ nawigacji wybranego elementu,

Powrót

Choice – nowy wybór

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

---

createResponse(response)

Tworzy nowy element ItemResponse dla tego elementu z wieloma odpowiedziami. Wyjątek jest rzucany, jeśli argument response nie pasuje do prawidłowego wyboru dla tego elementu, chyba że showOtherOption(enabled) ma wartość true.

Parametry

Nazwa	Typ	Opis
response	String	prawidłową odpowiedź na to pytanie jednokrotnego wyboru.

Powrót

ItemResponse – odpowiedź na element

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

---

duplicate()

Tworzy kopię tego elementu i dodaje ją na końcu formularza.

Powrót

MultipleChoiceItem – duplikat tego elementu MultipleChoiceItem, służący do łańcuchowania.

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

---

getChoices()

Pobiera wszystkie opcje dotyczące danego elementu.

Powrót

Choice[] – tablica opcji

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

---

getFeedbackForCorrect()

Zwraca opinię, która jest wyświetlana respondentom po udzieleniu przez nich prawidłowej odpowiedzi na pytanie.

Powrót

QuizFeedback – opinia (jeśli została przesłana).

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

---

getFeedbackForIncorrect()

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

Powrót

QuizFeedback – opinia (jeśli została przesłana).

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

---

getHelpText()

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

Powrót

String – tekst pomocy lub tekst opisu produktu,

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

---

getId()

Pobiera unikalny identyfikator produktu.

Powrót

Integer – identyfikator produktu

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

---

getIndex()

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

Powrót

Integer – indeks elementu

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

---

getPoints()

Zwraca liczbę punktów za element, który można ocenić.

Powrót

Integer – liczba punktów, jaką można uzyskać za pytanie.

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

---

getTitle()

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

Powrót

String – tytuł lub tekst nagłówka

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

---

getType()

Pobiera typ elementu jako ItemType.

Powrót

ItemType – typ elementu

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

---

hasOtherOption()

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

Powrót

Boolean – true, jeśli produkt ma opcję „inne”; false, jeśli nie

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

---

isRequired()

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

Powrót

Boolean – czy respondent musi odpowiedzieć na pytanie

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

---

setChoiceValues(values)

Ustawia opcje elementu na podstawie tablicy ciągów znaków. Wyjątek, jeśli podany 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

Nazwa	Typ	Opis
values	String[]	tablica wartości opcji, które respondenci widzą jako etykiety podczas wyświetlania formularza.

Powrót

MultipleChoiceItem – ta MultipleChoiceItem, aby utworzyć łańcuch

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

---

setChoices(choices)

Określa tablicę opcji dla elementu. Wyjątek jest zgłaszany, 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

Nazwa	Typ	Opis
choices	Choice[]	wiele opcji

Powrót

MultipleChoiceItem – ta MultipleChoiceItem, aby utworzyć łańcuch

Rzuty

Error – jeśli dana tablica jest tablicą null, pusta lub zawiera element null.

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

---

setFeedbackForCorrect(feedback)

Określa opinię, która ma być wyświetlana respondentom, gdy udzielą prawidłowej odpowiedzi 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

Nazwa	Typ	Opis
feedback	QuizFeedback	nową opinię. Wartość null spowoduje usunięcie opinii.

Powrót

MultipleChoiceItem – ta MultipleChoiceItem, aby utworzyć łańcuch

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

---

setFeedbackForIncorrect(feedback)

Określa komentarz, który ma być wyświetlany respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.

Parametry

Nazwa	Typ	Opis
feedback	QuizFeedback	nowe opinie

Powrót

MultipleChoiceItem – ta MultipleChoiceItem, aby utworzyć łańcuch

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

---

setHelpText(text)

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

Parametry

Nazwa	Typ	Opis
text	String	nowy tekst pomocy.

Powrót

MultipleChoiceItem – ta MultipleChoiceItem, aby utworzyć łańcuch

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

---

setPoints(points)

Określa liczbę punktów, które można przyznać ocenianemu elementowi. Wartość domyślna dla nowych elementów to 0.

Parametry

Nazwa	Typ	Opis
points	Integer	liczba punktów za pytanie

Powrót

MultipleChoiceItem – ta MultipleChoiceItem, aby utworzyć łańcuch

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

---

setRequired(enabled)

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

Parametry

Nazwa	Typ	Opis
enabled	Boolean	czy respondent musi udzielić odpowiedzi na pytanie.

Powrót

MultipleChoiceItem – bieżący element (do łańcuchowania).

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

---

setTitle(title)

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

Parametry

Nazwa	Typ	Opis
title	String	nowy tytuł lub tekst nagłówka.

Powrót

MultipleChoiceItem – ta MultipleChoiceItem, aby utworzyć łańcuch

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

---

showOtherOption(enabled)

Określa, czy element ma opcję „Inne”. Wartość domyślna dla nowego typu CheckboxItem lub MultipleChoiceItem to false.

Parametry

Nazwa	Typ	Opis
enabled	Boolean	true, jeśli produkt ma opcję „inne”; false, jeśli nie

Powrót

MultipleChoiceItem – ta MultipleChoiceItem, aby utworzyć łańcuch

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