Class ListItem

ListItem

Pytanie, w którym respondent może wybrać jedną odpowiedź z listy. Dostęp do elementów można uzyskać lub utworzyć je z poziomu 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

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 użytkownika 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 elementu listy.
duplicate()ListItemTworzy 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 spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu w postaci obiektu ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setChoiceValues(values)ListItemUstawia wybory dla elementu z tablicy ciągów znaków.
setChoices(choices)ListItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)ListItemUstawia informację zwrotną, która ma być wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
setFeedbackForIncorrect(feedback)ListItemUstawia opinię, która ma być wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
setHelpText(text)ListItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)ListItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)ListItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)ListItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

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 użytkownika 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 na stronie, nie można łączyć w tym samym elemencie z opcjami, które nie korzystają z nawigacji na stronie.

Nawigacja na 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 formularza. Nawigacja na stronie nie ma też wpływu na ostatnią stronę formularza.

Pamiętaj, że użycie nawigacji na stronie w przypadku elementu powoduje kodowanie trasy na stałe, co oznacza, że nie należy używać jednocześnie showOtherOption(true).

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 na stronie, nie można łączyć w tym samym elemencie z opcjami, które nie korzystają z nawigacji na stronie.

Nawigacja na 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 formularza. Nawigacja na stronie nie ma też wpływu na ostatnią stronę formularza.

Pamiętaj, że użycie nawigacji na stronie w przypadku elementu powoduje kodowanie trasy na stałe, co oznacza, że nie należy używać jednocześnie showOtherOption(true).

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

Parametry

NazwaTypOpis
responseStringprawidłowa odpowiedź na ten element listy

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

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

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 spoś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 liczbę punktów 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 czasami nazywany tekstem 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 w postaci obiektu 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

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

ListItem – ten ListItem 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

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ę wyborów,

Powrót

ListItem – ten ListItem do łączenia

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().setText('Dogs rule, cats drool.').build(),
);

Parametry

NazwaTypOpis
feedbackQuizFeedbacknową opinię. Wartość null spowoduje usunięcie opinii.

Powrót

ListItem – ten ListItem 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

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

ListItem – ten ListItem 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

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

ListItem – ten ListItem 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

setPoints(points)

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

Parametry

NazwaTypOpis
pointsIntegerliczbę punktów, jaką jest warta dana pozycja pytania;

Powrót

ListItem – ten ListItem 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

setRequired(enabled)

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

Parametry

NazwaTypOpis
enabledBooleanczy respondent musi odpowiedzieć na pytanie;

Powrót

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

ListItem – ten ListItem 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