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

Class ListItem

Pytanie, które umożliwia respondentowi wybranie jednej odpowiedzi z listy. Elementy można które można utworzyć lub uzyskać za pomocą: Form.

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

Metody

Metoda	Zwracany typ	Krótki opis
`createChoice(value)`	`Choice`	Tworzy nową opcję.
`createChoice(value, isCorrect)`	`Choice`	Tworzy nową opcję.
`createChoice(value, navigationItem)`	`Choice`	Służy do utworzenia nowej opcji z opcją nawigacji po stronie, która powoduje przejście do danego elementu podziału strony.
`createChoice(value, navigationType)`	`Choice`	Służy do tworzenia nowej opcji z opcją nawigacji na stronie.
`createResponse(response)`	`ItemResponse`	Tworzy nową wartość `ItemResponse` dla tego elementu listy.
`duplicate()`	`ListItem`	Tworzy kopię tego elementu i dołącza ją na końcu formularza.
`getChoices()`	`Choice[]`	Pobiera wszystkie opcje dotyczące elementu.
`getFeedbackForCorrect()`	`QuizFeedback`	Zwraca informację zwrotną, która wyświetla się użytkownikom, gdy udzielili prawidłowej odpowiedzi na pytanie.
`getFeedbackForIncorrect()`	`QuizFeedback`	Zwraca informację zwrotną, która jest wyświetlana użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.
`getHelpText()`	`String`	Pobiera tekst pomocy dotyczący elementu (nazywany czasem opisem w przypadku elementów układu takich jak `ImageItems`, `PageBreakItems` i `SectionHeaderItems`).
`getId()`	`Integer`	Pobiera unikalny identyfikator elementu.
`getIndex()`	`Integer`	Pobiera indeks elementu spośród wszystkich elementów w formularzu.
`getPoints()`	`Integer`	Zwraca wartość punktową elementu podlegającego ocenie.
`getTitle()`	`String`	Pobiera tytuł elementu (w przypadku `SectionHeaderItem` nazywany tekstem nagłówka).
`getType()`	`ItemType`	Pobiera typ elementu reprezentowany przez `ItemType`.
`isRequired()`	`Boolean`	Określa, czy użytkownik musi odpowiedzieć na pytanie.
`setChoiceValues(values)`	`ListItem`	Ustawia opcje elementu na podstawie tablicy ciągów znaków.
`setChoices(choices)`	`ListItem`	Ustawia tablicę opcji elementu.
`setFeedbackForCorrect(feedback)`	`ListItem`	Ustawia informację, że odpowiedzi będą wyświetlane użytkownikom, gdy odpowiedzą prawidłowo na pytanie.
`setFeedbackForIncorrect(feedback)`	`ListItem`	Określa, że odpowiedź na pytanie jest wyświetlana użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.
`setHelpText(text)`	`ListItem`	Ustawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak `ImageItems`, `PageBreakItems` i `SectionHeaderItems`).
`setPoints(points)`	`ListItem`	Określa liczbę punktów wartą oceniany element.
`setRequired(enabled)`	`ListItem`	Określa, czy użytkownik musi odpowiedzieć na pytanie.
`setTitle(title)`	`ListItem`	Określa tytuł elementu (w przypadku `SectionHeaderItem` nazywany też tekstem nagłówka).

Szczegółowa dokumentacja

`createChoice(value)`

Tworzy nową opcję.

Parametry

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

Powrót

Choice – nowa opcja

Autoryzacja

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ę.

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 – nowa opcja

Autoryzacja

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)`

Służy do utworzenia nowej opcji z opcją nawigacji po stronie, która powoduje przejście do danego elementu podziału strony. Ten jest odpowiednikiem funkcji createChoice(value, navigationType) z wartością navigationType ustawioną na FormApp.PageNavigationType.GO_TO_PAGE. Opcje, które używają strony elementów nawigacyjnych nie można łączyć w tym samym elemencie z opcjami, które nie używają nawigacji na stronie.

Nawigacja po stronie następuje po zakończeniu przez respondenta strony, która zawiera tę opcję. i tylko wtedy, gdy respondent wybrał tę opcję. Jeśli respondent wybrał wiele opcji z na danej stronie, działa tylko ostatnia opcja 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 – nowa opcja

Autoryzacja

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)`

Służy do tworzenia nowej opcji z opcją nawigacji na stronie. Opcje, które używają nawigacji na stronie, nie mogą być połączony w tym samym elemencie z opcjami, które nie używają nawigacji na stronie.

Parametry

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

Powrót

Choice – nowa opcja

Autoryzacja

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 nową wartość ItemResponse dla tego elementu listy. Zgłasza wyjątek, jeśli argument response nie pasuje do prawidłowej opcji tego elementu.

Parametry

Nazwa	Typ	Opis
`response`	`String`	prawidłowa odpowiedź na ten element listy

Powrót

ItemResponse – odpowiedź dotycząca produktu,

Autoryzacja

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.

Powrót

ListItem – duplikat kodu ListItem, na potrzeby tworzenia łańcuchów;

Autoryzacja

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.

Powrót

Choice[] – tablica opcji

Autoryzacja

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 informację zwrotną, która wyświetla się użytkownikom, gdy udzielili prawidłowej odpowiedzi na pytanie.

Powrót

QuizFeedback – ewentualne opinie.

Autoryzacja

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 informację zwrotną, która jest wyświetlana użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.

Powrót

QuizFeedback – ewentualne opinie.

Autoryzacja

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 (nazywany czasem opisem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy dotyczący produktu lub opis.

Autoryzacja

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.

Powrót

Integer – identyfikator produktu,

Autoryzacja

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 w formularzu.

Powrót

Integer – indeks elementu,

Autoryzacja

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.

Powrót

Integer – liczba punktów warte dane pytanie.

Autoryzacja

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 SectionHeaderItem nazywany tekstem nagłówka).

Powrót

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

Autoryzacja

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 przez ItemType.

Powrót

ItemType – typ elementu,

Autoryzacja

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.

Powrót

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

Autoryzacja

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 na podstawie tablicy ciągów znaków. Zgłasza wyjątek, jeśli dana tablica jest puste.

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

Nazwa	Typ	Opis
`values`	`String[]`	tablicę wartości wyboru, którą respondenci widzą jako etykiety podczas przeglądania formularza

Powrót

ListItem – ListItem, łańcuch

Autoryzacja

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 elementu. Zgłasza wyjątek, jeśli dana 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

Nazwa	Typ	Opis
`choices`	`Choice[]`	szeroki wybór

Powrót

ListItem – ListItem, łańcuch

Rzuty

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

Autoryzacja

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)`

Ustawia informację, że odpowiedzi będą wyświetlane użytkownikom, gdy odpowiedzą prawidłowo na pytanie.

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

Nazwa	Typ	Opis
`feedback`	`QuizFeedback`	nowych opinii. Wartość null usuwa informację zwrotną.

Powrót

ListItem – ListItem, łańcuch

Autoryzacja

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, że odpowiedź na pytanie jest wyświetlana użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.

Parametry

Nazwa	Typ	Opis
`feedback`	`QuizFeedback`	nowa opinia

Powrót

ListItem – ListItem, łańcuch

Autoryzacja

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 elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

Nazwa	Typ	Opis
`text`	`String`	nowy tekst pomocy

Powrót

ListItem – ListItem, łańcuch

Autoryzacja

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 wartą oceniany element. Wartość domyślna nowych elementów to 0.

Parametry

Nazwa	Typ	Opis
`points`	`Integer`	liczba punktów warta przedmiot pytania

Powrót

ListItem – ListItem, łańcuch

Autoryzacja

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

Nazwa	Typ	Opis
`enabled`	`Boolean`	czy respondent musi odpowiedzieć na pytanie,

Powrót

ListItem – bieżący element (do tworzenia łańcuchów),

Autoryzacja

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)`

Określa tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka).

Parametry

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

Powrót

ListItem – ListItem, łańcuch

Autoryzacja

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