Class ListItem

ListItem

Element pytania, który umożliwia respondentowi wybranie jednej opcji z listy. Elementy można tworzyć i otwierać w ramach Form.

// 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?').setChoices([
  item.createChoice('Cats'), item.createChoice('Dogs')
]);

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 na liście.
duplicate()	ListItem	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.
isRequired()	Boolean	Określa, czy respondent musi odpowiedzieć na pytanie.
setChoiceValues(values)	ListItem	Ustawia opcje elementu na podstawie tablicy ciągów znaków.
setChoices(choices)	ListItem	Określa tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)	ListItem	Określa opinię, która ma być wyświetlana respondentom, gdy udzielą prawidłowej odpowiedzi na pytanie.
setFeedbackForIncorrect(feedback)	ListItem	Określa komentarz, który ma być wyświetlany respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
setHelpText(text)	ListItem	Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)	ListItem	Określa liczbę punktów, które można przyznać ocenianemu elementowi.
setRequired(enabled)	ListItem	Określa, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)	ListItem	Ustawia tytuł produktu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

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 na liście. Wyjątek jest zgłaszany, jeśli argument response nie jest prawidłowym wyborem dla tego elementu.

Parametry

Nazwa	Typ	Opis
response	String	prawidłowa odpowiedź dla tego elementu listy,

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

ListItem – duplikat tego elementu ListItem, 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

---

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

ListItem – ta ListItem, 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

ListItem – ta ListItem, 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

ListItem – ta ListItem, 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

ListItem – ta ListItem, 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

ListItem – ta ListItem, 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

ListItem – ta ListItem, 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

ListItem – 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ł produktu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

Parametry

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

Powrót

ListItem – ta ListItem, 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