Pytanie, w którym respondent może zaznaczyć co najmniej jedno pole wyboru, a także opcjonalne pole „Inne”. Elementy są tworzone lub dostępne z Form za pomocą metod takich jak Form.addCheckboxItem(). Gdy są używane w quizie, te elementy są oceniane automatycznie.
// Open a form by ID and add a new checkbox item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish'), ]) .showOtherOption(true);
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
clear | Checkbox | Usuwa sprawdzanie poprawności danych w przypadku tego pola wyboru. |
create | Choice | Tworzy nowy wybór. |
create | Choice | Tworzy nowy wybór. |
create | Item | Tworzy nowy element Item dla tego pola wyboru. |
duplicate() | Checkbox | Tworzy kopię tego elementu i dołącza ją na końcu formularza. |
get | Choice[] | Pobiera wszystkie opcje elementu. |
get | Quiz | Zwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie, gdy udzielą prawidłowej odpowiedzi. |
get | Quiz | Zwraca opinię, która jest wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie. |
get | String | Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak Image, Page i Section). |
get | Integer | Pobiera unikalny identyfikator elementu. |
get | Integer | Pobiera indeks elementu spośród wszystkich elementów w formularzu. |
get | Integer | Zwraca liczbę punktów elementu podlegającego ocenie. |
get | String | Pobiera tytuł elementu (w przypadku Section czasami nazywany tekstem nagłówka). |
get | Item | Pobiera typ elementu reprezentowany jako Item. |
has | Boolean | Określa, czy element ma opcję „Inne”. |
is | Boolean | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Checkbox | Ustawia wybory dla elementu z tablicy ciągów znaków. |
set | Checkbox | Ustawia tablicę opcji dla elementu. |
set | Checkbox | Ustawia informację zwrotną, która ma być wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie. |
set | Checkbox | Ustawia opinię, która ma być wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie. |
set | Checkbox | Ustawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak Image, Page i Section). |
set | Checkbox | Ustawia liczbę punktów, jaką jest warta oceniana pozycja. |
set | Checkbox | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Checkbox | Ustawia tytuł elementu (w przypadku Section czasami nazywany tekstem nagłówka). |
set | Checkbox | Ustawia sprawdzanie poprawności danych dla tego pola wyboru. |
show | Checkbox | Określa, czy element ma opcję „Inna odpowiedź”. |
Szczegółowa dokumentacja
clearValidation()
Usuwa sprawdzanie poprawności danych w przypadku tego pola wyboru.
Powrót
CheckboxItem – ten CheckboxItem 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
createChoice(value)
Tworzy nowy wybór.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
value | String | wartość 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
| Nazwa | Typ | Opis |
|---|---|---|
value | String | wartość wyboru, która jest wyświetlana respondentom jako etykieta podczas przeglądania formularza; |
is | Boolean | czy 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
createResponse(responses)
Tworzy nowy element ItemResponse dla tego pola wyboru. Argument responses to tablica String[] zawierająca wartości, które należy sprawdzić. Zgłasza wyjątek, jeśli jakakolwiek wartość nie pasuje do prawidłowego wyboru dla tego elementu, chyba że parametr showOtherOption(enabled) jest ustawiony na true.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
responses | String[] | tablica prawidłowych odpowiedzi na to pytanie jednokrotnego wyboru. |
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
CheckboxItem – duplikat tego CheckboxItem 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()
getFeedbackForCorrect()
Zwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie, gdy udzielą prawidłowej odpowiedzi.
Powrót
QuizFeedback|null – opinia (jeśli występuje).
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 występuje).
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 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
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()
hasOtherOption()
Określa, czy element ma opcję „Inne”.
Powrót
Boolean – true, jeśli element ma opcję „Inne”; false, jeśli nie.
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
| Nazwa | Typ | Opis |
|---|---|---|
values | String[] | tablica wartości do wyboru, które respondenci widzą jako etykiety podczas wyświetlania formularza; |
Powrót
CheckboxItem – ten CheckboxItem 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
| Nazwa | Typ | Opis |
|---|---|---|
choices | Choice[] | tablicę opcji, |
Powrót
CheckboxItem – ten CheckboxItem do łączenia
Rzuty
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
| Nazwa | Typ | Opis |
|---|---|---|
feedback | Quiz | nową opinię. Wartość null spowoduje usunięcie opinii. |
Powrót
CheckboxItem – ten CheckboxItem 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
| Nazwa | Typ | Opis |
|---|---|---|
feedback | Quiz | nowa opinia. |
Powrót
CheckboxItem – ten CheckboxItem 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
| Nazwa | Typ | Opis |
|---|---|---|
text | String | nowy tekst pomocy, |
Powrót
CheckboxItem – ten CheckboxItem 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
| Nazwa | Typ | Opis |
|---|---|---|
points | Integer | liczbę punktów, jaką jest warta pozycja pytania; |
Powrót
CheckboxItem – ten CheckboxItem 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
| Nazwa | Typ | Opis |
|---|---|---|
enabled | Boolean | czy respondent musi odpowiedzieć na pytanie; |
Powrót
CheckboxItem – bieżący element (do łączenia w łańcuch)
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
| Nazwa | Typ | Opis |
|---|---|---|
title | String | nowy tytuł lub tekst nagłówka; |
Powrót
CheckboxItem – ten CheckboxItem 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
setValidation(validation)
Ustawia sprawdzanie poprawności danych dla tego pola wyboru. Przekazanie wartości null lub weryfikacji bez wywołania funkcji require spowoduje usunięcie wcześniejszej weryfikacji.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
validation | Checkbox | obiekt CheckboxValidation, który ma zostać zastosowany do tego elementu. |
Powrót
CheckboxItem – ten CheckboxItem 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
showOtherOption(enabled)
Określa, czy element ma opcję „Inna odpowiedź”. Domyślna wartość nowego elementu CheckboxItem lub MultipleChoiceItem to false.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
enabled | Boolean | true jeśli element ma opcję „Inne”; false w przeciwnym razie. |
Powrót
CheckboxItem – ten CheckboxItem 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