Class ListItem

ListItem

Element pytania, który umożliwia użytkownikowi wybranie jednej opcji z listy. Elementy można otworzyć lub utworzyć 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

MetodaZwracany typKrótki opis
createChoice(value)ChoiceTworzy nową opcję wyboru.
createChoice(value, isCorrect)ChoiceTworzy nową opcję wyboru.
createChoice(value, navigationItem)ChoiceTworzy nową opcję z opcją nawigacji, która przechodzi do konkretnego elementu podziału strony.
createChoice(value, navigationType)ChoiceTworzy nową opcję z opcją nawigacji po stronie.
createResponse(response)ItemResponseTworzy nowy element ItemResponse dla tej pozycji na liście.
duplicate()ListItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje dotyczące elementu.
getFeedbackForCorrect()QuizFeedbackZwraca komentarz wyświetlany użytkownikom, którzy odpowiedzą prawidłowo na pytanie.
getFeedbackForIncorrect()QuizFeedbackZwraca informacje zwrotne, które są wyświetlane użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.
getHelpText()StringPobiera tekst pomocy dotyczący 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 formularza.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setChoiceValues(values)ListItemUstawia opcje elementu z tablicy ciągów tekstowych.
setChoices(choices)ListItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)ListItemOkreśla informacje, które będą wyświetlane respondentom, gdy odpowiedzą na pytanie poprawnie.
setFeedbackForIncorrect(feedback)ListItemOkreśla komentarz, który będzie wyświetlany użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.
setHelpText(text)ListItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)ListItemOkreśla liczbę punktów za element, który można ocenić.
setRequired(enabled)ListItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)ListItemUstawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).

Szczegółowa dokumentacja

createChoice(value)

Tworzy nową opcję wyboru.

Parametry

NazwaTypOpis
valueStringwartości wyboru, którą ankietowani widzą jako etykietę podczas wyświetlania formularza.

Powroty

Choice – nowa opcja

Upoważnienie

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

Parametry

NazwaTypOpis
valueStringwartości wyboru, którą ankietowani widzą jako etykietę podczas wyświetlania formularza.
isCorrectBooleanczy wybrana odpowiedź jest poprawna,

Powroty

Choice – nowa opcja

Upoważnienie

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)

Tworzy nową opcję z opcją nawigacji, która przechodzi do konkretnego elementu podziału strony. Jest to odpowiednik funkcji createChoice(value, navigationType) z parametrem navigationType ustawionym na FormApp.PageNavigationType.GO_TO_PAGE. Wyborów służących do nawigacji po stronie nie można łączyć w jednym elemencie z opcjami, które nie korzystają z nawigacji po stronie.

Nawigacja na stronie ma miejsce po wypełnieniu strony, na której znajduje się dana opcja, i tylko wtedy, gdy użytkownik ją wybrał. Jeśli respondent wybrał wiele opcji z instrukcjami nawigacji na stronie na tej samej stronie, efektem będzie tylko ostatnia opcja nawigacji. Nawigacja na stronie nie ma też wpływu na ostatnią stronę formularza.

Parametry

NazwaTypOpis
valueStringwartości wyboru, którą ankietowani widzą jako etykietę podczas wyświetlania formularza.
navigationItemPageBreakItemelement, do którego chcesz przejść

Powroty

Choice – nowa opcja

Upoważnienie

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)

Tworzy nową opcję z opcją nawigacji po stronie. Wyborów dotyczących nawigacji na stronie nie można łączyć w ramach tego samego elementu z opcjami, które nie korzystają z nawigacji po stronie.

Nawigacja na stronie ma miejsce po wypełnieniu strony, na której znajduje się dana opcja, i tylko wtedy, gdy użytkownik ją wybrał. Jeśli respondent wybrał wiele opcji z instrukcjami nawigacji na stronie na tej samej stronie, efektem będzie tylko ostatnia opcja nawigacji. Nawigacja na stronie nie ma też wpływu na ostatnią stronę formularza.

Parametry

NazwaTypOpis
valueStringwartości wyboru, którą ankietowani widzą jako etykietę podczas wyświetlania formularza.
navigationTypePageNavigationTypetyp nawigacji dla opcji wyboru

Powroty

Choice – nowa opcja

Upoważnienie

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 nowy element ItemResponse dla tej pozycji na liście. Zwraca wyjątek, jeśli argument response nie pasuje do prawidłowej opcji dla tego elementu.

Parametry

NazwaTypOpis
responseStringpoprawna odpowiedź dla tej pozycji na liście

Powroty

ItemResponse – odpowiedź dotycząca produktu,

Upoważnienie

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.

Powroty

ListItem – duplikat elementu ListItem na potrzeby łańcuchów

Upoważnienie

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.

Powroty

Choice[] – tablica dostępnych opcji.

Upoważnienie

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 komentarz wyświetlany użytkownikom, którzy odpowiedzą prawidłowo na pytanie.

Powroty

QuizFeedback – ewentualna opinia.

Upoważnienie

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 informacje zwrotne, które są wyświetlane użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.

Powroty

QuizFeedback – ewentualna opinia.

Upoważnienie

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

Powroty

String – tekst pomocy lub opis dotyczący produktu.

Upoważnienie

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.

Powroty

Integer – identyfikator produktu,

Upoważnienie

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

Powroty

Integer – indeks elementu;

Upoważnienie

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.

Powroty

Integer – liczba punktów, za jaką pytanie jest warte pytanie.

Upoważnienie

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

Powroty

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

Upoważnienie

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

Powroty

ItemType – typ elementu;

Upoważnienie

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.

Powroty

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

Upoważnienie

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 z tablicy ciągów tekstowych. Zgłasza wyjątek, jeśli podana tablica jest pusta.

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

NazwaTypOpis
valuesString[]w tablicy wartości wyboru, które użytkownicy widzą jako etykiety podczas wyświetlania formularza.

Powroty

ListItem – ten ListItem, do łańcuchów

Upoważnienie

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

NazwaTypOpis
choicesChoice[]szeroki wybór opcji

Powroty

ListItem – ten ListItem, do łańcuchów

Rzuty

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

Upoważnienie

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)

Określa informacje, które będą wyświetlane respondentom, gdy odpowiedzą na pytanie poprawnie.

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

NazwaTypOpis
feedbackQuizFeedbacknowych informacji zwrotnych. Wartość null spowoduje wyczyszczenie opinii.

Powroty

ListItem – ten ListItem, do łańcuchów

Upoważnienie

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 komentarz, który będzie wyświetlany użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowa opinia

Powroty

ListItem – ten ListItem, do łańcuchów

Upoważnienie

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

Parametry

NazwaTypOpis
textStringnowy tekst pomocy

Powroty

ListItem – ten ListItem, do łańcuchów

Upoważnienie

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 za element, który można ocenić. Wartość domyślna nowych elementów to 0.

Parametry

NazwaTypOpis
pointsIntegerliczba punktów wartych pytania

Powroty

ListItem – ten ListItem, do łańcuchów

Upoważnienie

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

NazwaTypOpis
enabledBooleanczy respondent musi odpowiedzieć na pytanie,

Powroty

ListItem – bieżący element (na potrzeby łańcuszków)

Upoważnienie

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)

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

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka.

Powroty

ListItem – ten ListItem, do łańcuchów

Upoważnienie

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