Ta strona została przetłumaczona przez Cloud Translation API.

Class 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ł elementu (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.

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ł elementu (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