Element pytania, który umożliwia respondentowi wybranie jednej opcji z listy przycisków lub opcjonalnego pola „inne”. Elementy można otworzyć lub utworzyć za pomocą: Form
. W quizie są one oceniane automatycznie.
// Open a form by ID and add a new multiple choice item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addMultipleChoiceItem(); item.setTitle('Do you prefer cats or dogs?') .setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]) .showOtherOption(true);
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
createChoice(value) | Choice | Tworzy nową opcję wyboru. |
createChoice(value, isCorrect) | Choice | Tworzy nową opcję wyboru. |
createChoice(value, navigationItem) | Choice | Tworzy nową opcję z opcją nawigacji, która przechodzi do konkretnego elementu podziału strony. |
createChoice(value, navigationType) | Choice | Tworzy nową opcję z opcją nawigacji po stronie. |
createResponse(response) | ItemResponse | Tworzy nowy element ItemResponse dla tego produktu wielokrotnego wyboru. |
duplicate() | MultipleChoiceItem | Tworzy kopię tego elementu i dołącza ją na końcu formularza. |
getChoices() | Choice[] | Pobiera wszystkie opcje dotyczące elementu. |
getFeedbackForCorrect() | QuizFeedback | Zwraca komentarz wyświetlany użytkownikom, którzy odpowiedzą prawidłowo na pytanie. |
getFeedbackForIncorrect() | QuizFeedback | Zwraca informacje zwrotne, które są wyświetlane użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie. |
getHelpText() | String | Pobiera tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu 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 formularza. |
getPoints() | Integer | Zwraca wartość punktową elementu podlegającego ocenie. |
getTitle() | String | Pobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
getType() | ItemType | Pobiera typ elementu, reprezentowany jako ItemType . |
hasOtherOption() | Boolean | Określa, czy dla elementu jest dostępna opcja „inne”. |
isRequired() | Boolean | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setChoiceValues(values) | MultipleChoiceItem | Ustawia opcje elementu z tablicy ciągów tekstowych. |
setChoices(choices) | MultipleChoiceItem | Ustawia tablicę opcji dla elementu. |
setFeedbackForCorrect(feedback) | MultipleChoiceItem | Określa informacje, które będą wyświetlane respondentom, gdy odpowiedzą na pytanie poprawnie. |
setFeedbackForIncorrect(feedback) | MultipleChoiceItem | Określa komentarz, który będzie wyświetlany użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie. |
setHelpText(text) | MultipleChoiceItem | Ustawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
setPoints(points) | MultipleChoiceItem | Określa liczbę punktów za element, który można ocenić. |
setRequired(enabled) | MultipleChoiceItem | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setTitle(title) | MultipleChoiceItem | Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
showOtherOption(enabled) | MultipleChoiceItem | Określa, czy dla elementu jest dostępna opcja „inne”. |
Szczegółowa dokumentacja
createChoice(value)
Tworzy nową opcję wyboru.
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | wartoś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
Nazwa | Typ | Opis |
---|---|---|
value | String | wartości wyboru, którą ankietowani widzą jako etykietę podczas wyświetlania formularza. |
isCorrect | Boolean | czy 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
Nazwa | Typ | Opis |
---|---|---|
value | String | wartości wyboru, którą ankietowani widzą jako etykietę podczas wyświetlania formularza. |
navigationItem | PageBreakItem | element, 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
createResponse(response)
Tworzy nowy element ItemResponse
dla tego produktu wielokrotnego wyboru. Zwraca wyjątek, jeśli argument response
nie pasuje do prawidłowej opcji dla tego elementu, chyba że showOtherOption(enabled)
ma wartość true
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
response | String | poprawna odpowiedź dotycząca tego elementu wielokrotnego wyboru |
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
MultipleChoiceItem
– duplikat elementu MultipleChoiceItem
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()
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()
hasOtherOption()
Określa, czy dla elementu jest dostępna opcja „inne”.
Powroty
Boolean
– true
, jeśli element ma opcję „inne”, lub false
, jeśli nie jest dostępna
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
Nazwa | Typ | Opis |
---|---|---|
values | String[] | w tablicy wartości wyboru, które użytkownicy widzą jako etykiety podczas wyświetlania formularza. |
Powroty
MultipleChoiceItem
– ten MultipleChoiceItem
, 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
Nazwa | Typ | Opis |
---|---|---|
choices | Choice[] | szeroki wybór opcji |
Powroty
MultipleChoiceItem
– ten MultipleChoiceItem
, 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
Nazwa | Typ | Opis |
---|---|---|
feedback | QuizFeedback | nowych informacji zwrotnych. Wartość null spowoduje wyczyszczenie opinii. |
Powroty
MultipleChoiceItem
– ten MultipleChoiceItem
, 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
Nazwa | Typ | Opis |
---|---|---|
feedback | QuizFeedback | nowa opinia |
Powroty
MultipleChoiceItem
– ten MultipleChoiceItem
, 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
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy |
Powroty
MultipleChoiceItem
– ten MultipleChoiceItem
, 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
Nazwa | Typ | Opis |
---|---|---|
points | Integer | liczba punktów wartych pytania |
Powroty
MultipleChoiceItem
– ten MultipleChoiceItem
, 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
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | czy respondent musi odpowiedzieć na pytanie, |
Powroty
MultipleChoiceItem
– 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
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka. |
Powroty
MultipleChoiceItem
– ten MultipleChoiceItem
, 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
showOtherOption(enabled)
Określa, czy dla elementu jest dostępna opcja „inne”. Wartością domyślną CheckboxItem
lub MultipleChoiceItem
jest false
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli element ma opcję „inne”, lub „false ” w przeciwnym razie |
Powroty
MultipleChoiceItem
– ten MultipleChoiceItem
, 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