Element pytania, który umożliwia respondentowi zaznaczenie co najmniej jednego pola wyboru, a także opcjonalne pole „inne”. Elementy można tworzyć i otwierać w ramach Form
. Gdy są używane w teście, są automatycznie oceniane.
// 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 dla tego elementu pola wyboru. |
create | Choice | Tworzy nowy wybór. |
create | Choice | Tworzy nowy wybór. |
create | Item | Tworzy nowy element Item dla tego elementu z polem wyboru. |
duplicate() | Checkbox | Tworzy kopię tego elementu i dodaje ją na końcu formularza. |
get | Choice[] | Pobiera wszystkie opcje dotyczące danego elementu. |
get | Quiz | Zwraca opinię, która jest wyświetlana respondentom po udzieleniu przez nich prawidłowej odpowiedzi na pytanie. |
get | Quiz | Zwraca opinię, która jest wyświetlana respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie. |
get | String | Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image , Page i Section ). |
get | Integer | Pobiera unikalny identyfikator produktu. |
get | Integer | Pobiera indeks elementu spośród wszystkich elementów w formularzu. |
get | Integer | Zwraca liczbę punktów za element, który można ocenić. |
get | String | Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section ). |
get | Item | Pobiera typ elementu jako Item . |
has | Boolean | Określa, czy element ma opcję „Inne”. |
is | Boolean | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Checkbox | Ustawia opcje elementu na podstawie tablicy ciągów znaków. |
set | Checkbox | Określa tablicę opcji dla elementu. |
set | Checkbox | Określa opinię, która ma być wyświetlana respondentom, gdy udzielą prawidłowej odpowiedzi na pytanie. |
set | Checkbox | Określa komentarz, który ma być wyświetlany respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie. |
set | Checkbox | Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image , Page i Section ). |
set | Checkbox | Określa liczbę punktów, które można przyznać ocenianemu elementowi. |
set | Checkbox | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Checkbox | Ustawia tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section ). |
set | Checkbox | Ustawia sprawdzanie poprawności danych dla tego elementu pola wyboru. |
show | Checkbox | Określa, czy element ma opcję „Inne”. |
Szczegółowa dokumentacja
clear Validation()
Usuwa sprawdzanie poprawności danych dla tego elementu pola wyboru.
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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
create Choice(value)
Tworzy nowy wybór.
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza. |
Powrót
Choice
– nowy wybór
Autoryzacja
Skrypty, które korzystają 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
create Choice(value, isCorrect)
Tworzy nowy wybór.
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza. |
is | Boolean | czy wybrana odpowiedź jest poprawna. |
Powrót
Choice
– nowy wybór
Autoryzacja
Skrypty, które korzystają 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
create Response(responses)
Tworzy nowy element Item
dla tego elementu z polem wyboru. Argument responses
to tablica String[]
zawierająca wartości, które należy sprawdzić. Wyjątek jest zgłaszany, jeśli jakakolwiek wartość nie pasuje do prawidłowego wyboru dla tego elementu, chyba że show
ma wartość true
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
responses | String[] | tablica prawidłowych odpowiedzi na to pytanie jednokrotnego wyboru. |
Powrót
Item
– odpowiedź na element
Autoryzacja
Skrypty, które korzystają 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 dodaje ją na końcu formularza.
Powrót
Checkbox
– duplikat tego elementu Checkbox
, służący do łańcuchowania.
Autoryzacja
Skrypty, które korzystają 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
get Choices()
get Feedback For Correct()
Zwraca opinię, która jest wyświetlana respondentom po udzieleniu przez nich prawidłowej odpowiedzi na pytanie.
Powrót
Quiz
– opinia (jeśli została przesłana).
Autoryzacja
Skrypty, które korzystają 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
get Feedback For Incorrect()
Zwraca opinię, która jest wyświetlana respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
Powrót
Quiz
– opinia (jeśli została przesłana).
Autoryzacja
Skrypty, które korzystają 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
get Help Text()
Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image
, Page
i Section
).
Powrót
String
– tekst pomocy lub tekst opisu produktu,
Autoryzacja
Skrypty, które korzystają 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
get Id()
Pobiera unikalny identyfikator produktu.
Powrót
Integer
– identyfikator produktu
Autoryzacja
Skrypty, które korzystają 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
get Index()
Pobiera indeks elementu spośród wszystkich elementów w formularzu.
Powrót
Integer
– indeks elementu
Autoryzacja
Skrypty, które korzystają 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
get Points()
Zwraca liczbę punktów za element, który można ocenić.
Powrót
Integer
– liczba punktów, jaką można uzyskać za pytanie.
Autoryzacja
Skrypty, które korzystają 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
get Title()
Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section
).
Powrót
String
– tytuł lub tekst nagłówka
Autoryzacja
Skrypty, które korzystają 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
get Type()
has Other Option()
Określa, czy element ma opcję „Inne”.
Powrót
Boolean
– true
, jeśli produkt ma opcję „inne”; false
, jeśli nie
Autoryzacja
Skrypty, które korzystają 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
is Required()
Określa, czy respondent musi odpowiedzieć na pytanie.
Powrót
Boolean
– czy respondent musi odpowiedzieć na pytanie
Autoryzacja
Skrypty, które korzystają 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
set Choice Values(values)
Ustawia opcje elementu na podstawie tablicy ciągów znaków. Wyjątek, jeśli podany 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 opcji, które respondenci widzą jako etykiety podczas wyświetlania formularza. |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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
set Choices(choices)
Określa tablicę opcji dla elementu. Wyjątek jest zgłaszany, 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[] | wiele opcji |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch
Rzuty
Error
– jeśli dana tablica jest tablicą null
, pusta lub zawiera element null
.
Autoryzacja
Skrypty, które korzystają 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
set Feedback For Correct(feedback)
Określa opinię, która ma być wyświetlana respondentom, gdy udzielą prawidłowej odpowiedzi 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().setDisplayText('Dogs rule, cats drool.').build(), );
Parametry
Nazwa | Typ | Opis |
---|---|---|
feedback | Quiz | nową opinię. Wartość null spowoduje usunięcie opinii. |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch.
Autoryzacja
Skrypty, które korzystają 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
set Feedback For Incorrect(feedback)
Określa komentarz, który ma być wyświetlany respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
feedback | Quiz | nowe opinie |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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
set Help Text(text)
Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image
, Page
i Section
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy. |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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
set Points(points)
Określa liczbę punktów, które można przyznać ocenianemu elementowi. Wartość domyślna dla nowych elementów to 0.
Parametry
Nazwa | Typ | Opis |
---|---|---|
points | Integer | liczba punktów za pytanie |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch.
Autoryzacja
Skrypty, które korzystają 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
set Required(enabled)
Określa, czy respondent musi odpowiedzieć na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | czy respondent musi udzielić odpowiedzi na pytanie. |
Powrót
Checkbox
– bieżący element (do łańcuchowania).
Autoryzacja
Skrypty, które korzystają 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
set Title(title)
Ustawia tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka. |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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
set Validation(validation)
Ustawia sprawdzanie poprawności danych dla tego elementu pola wyboru. Przekazanie wartości null lub walidacji bez wywołania funkcji require spowoduje usunięcie wcześniejszej walidacji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
validation | Checkbox | pole wyboru, które pozwala zastosować tę funkcję do tego produktu. |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch.
Autoryzacja
Skrypty, które korzystają 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
show Other Option(enabled)
Określa, czy element ma opcję „Inne”. Wartość domyślna dla nowego typu Checkbox
lub Multiple
to false
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli produkt ma opcję „inne”; false , jeśli nie |
Powrót
Checkbox
– ta Checkbox
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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