Element pytania, który umożliwia respondentowi zaznaczenie jednego lub kilku pól wyboru, a także opcjonalne pole "other". Elementy są dostępne i można je tworzyć na stronie Form
. W przypadku quizu elementy te są automatycznie oceniane.
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var 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 |
---|---|---|
clearValidation() | CheckboxItem | Usuwa wszystkie zatwierdzenia danych tego elementu. |
createChoice(value) | Choice | Spowoduje nowy wybór. |
createChoice(value, isCorrect) | Choice | Spowoduje nowy wybór. |
createResponse(responses) | ItemResponse | Tworzy nowy element: ItemResponse dla tego pola wyboru. |
duplicate() | CheckboxItem | Tworzy kopię tego elementu i dołącza ją na końcu formularza. |
getChoices() | Choice[] | Pobiera wszystkie odpowiedzi dotyczące elementu. |
getFeedbackForCorrect() | QuizFeedback | Zwraca opinię widoczną dla użytkowników, gdy odpowiedzą poprawnie na pytanie. |
getFeedbackForIncorrect() | QuizFeedback | Zwraca opinię wyświetlaną osobom, które nieprawidłowo odpowiedzieli na pytanie. |
getHelpText() | String | Pobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
getId() | Integer | Pobiera unikalny identyfikator elementu. |
getIndex() | Integer | Pobiera indeks elementu do wszystkich elementów w formularzu. |
getPoints() | Integer | Zwraca wartość punktową elementu możliwego do oceny. |
getTitle() | String | Pobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem ). |
getType() | ItemType | Pobiera typ elementu reprezentowany jako ItemType . |
hasOtherOption() | Boolean | Określa, czy element ma opcję "other". |
isRequired() | Boolean | Określa, czy respondent musi odpowiedzieć na pytanie. |
setChoiceValues(values) | CheckboxItem | Ustawia wybór elementu z tablicy ciągów. |
setChoices(choices) | CheckboxItem | Ustawia tablicę opcji dla elementu. |
setFeedbackForCorrect(feedback) | CheckboxItem | Określa, jaka opinia ma być widoczna dla użytkowników, gdy prawidłowo odpowiedzą na pytanie. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Umożliwiają wyświetlanie odpowiedzi, gdy użytkownik odpowie nieprawidłowo na pytanie. |
setHelpText(text) | CheckboxItem | Ustawia tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
setPoints(points) | CheckboxItem | Określa liczbę punktów, które może mieć wartość z możliwością oceny. |
setRequired(enabled) | CheckboxItem | Określa, czy respondent musi odpowiedzieć na pytanie. |
setTitle(title) | CheckboxItem | Ustawia tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem ). |
setValidation(validation) | CheckboxItem | Ustawia weryfikację danych tego elementu. |
showOtherOption(enabled) | CheckboxItem | Określa, czy element ma opcję "other". |
Szczegółowa dokumentacja
clearValidation()
Usuwa wszystkie zatwierdzenia danych tego elementu.
Zwróć
CheckboxItem
– ten CheckboxItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value)
Spowoduje nowy wybór.
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | wartość wyboru, którą ankietowani widzą jako etykietę podczas przeglądania formularza; |
Zwróć
Choice
– nowa opcja
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value, isCorrect)
Spowoduje nowy wybór.
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | wartość wyboru, którą ankietowani widzą jako etykietę podczas przeglądania formularza; |
isCorrect | Boolean | czy odpowiedź jest prawidłowa |
Zwróć
Choice
– nowa opcja
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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
jest tablicą String[]
zawierającą wartości, które należy sprawdzić. Zwraca wyjątek, jeśli którakolwiek wartość nie pasuje do prawidłowego wyboru dla tego elementu, chyba że showOtherOption(enabled)
ma wartość true
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
responses | String[] | tablica prawidłowych odpowiedzi dla tego pytania jednokrotnego wyboru |
Zwróć
ItemResponse
– odpowiedź elementu;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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.
Zwróć
CheckboxItem
– duplikat pytania „CheckboxItem
” dotyczący łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getChoices()
getFeedbackForCorrect()
Zwraca opinię widoczną dla użytkowników, gdy odpowiedzą poprawnie na pytanie.
Zwróć
QuizFeedback
– opinia (jeśli istnieje).
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getFeedbackForIncorrect()
Zwraca opinię wyświetlaną osobom, które nieprawidłowo odpowiedzieli na pytanie.
Zwróć
QuizFeedback
– opinia (jeśli istnieje).
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Zwróć
String
– tekst pomocy lub opis elementu;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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.
Zwróć
Integer
– identyfikator elementu;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Pobiera indeks elementu do wszystkich elementów w formularzu.
Zwróć
Integer
– indeks elementu
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPoints()
Zwraca wartość punktową elementu możliwego do oceny.
Zwróć
Integer
– liczba punktów przyznawanych za pytanie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Pobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem
).
Zwróć
String
– tytuł lub tekst nagłówka;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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ę "other".
Zwróć
Boolean
– true
, jeśli element ma opcję "other" jeśli nie, false
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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.
Zwróć
Boolean
– czy użytkownik musi odpowiedzieć na pytanie;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoiceValues(values)
Ustawia wybór elementu z tablicy ciągów. Zwraca wyjątek, jeśli dana 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[] | tablica wartości wyboru, które ankietowani widzą jako etykiety podczas przeglądania formularza; |
Zwróć
CheckboxItem
– ten CheckboxItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 dana 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 |
Zwróć
CheckboxItem
– ten CheckboxItem
do łańcucha
Narzuty
Error
– jeśli podana tablica jest null
, pusta lub zawiera element null
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForCorrect(feedback)
Określa, jaka opinia ma być widoczna dla użytkowników, gdy prawidłowo odpowiedzą na pytanie.
// 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 | nową opinię. Wartość null spowoduje usunięcie opinii. |
Zwróć
CheckboxItem
– ten CheckboxItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
Umożliwiają wyświetlanie odpowiedzi, gdy użytkownik odpowie nieprawidłowo na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
feedback | QuizFeedback | nowa opinia |
Zwróć
CheckboxItem
– ten CheckboxItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy |
Zwróć
CheckboxItem
– ten CheckboxItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
Określa liczbę punktów, które może mieć wartość z możliwością oceny. Domyślnie nowe elementy mają wartość 0.
Parametry
Nazwa | Typ | Opis |
---|---|---|
points | Integer | liczbę punktów przyznawanych za pytanie |
Zwróć
CheckboxItem
– ten CheckboxItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 użytkownik musi odpowiedzieć na pytanie; |
Zwróć
CheckboxItem
– bieżący element (łańcuch)
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowego tytułu lub tekstu nagłówka, |
Zwróć
CheckboxItem
– ten CheckboxItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
Ustawia weryfikację danych tego elementu. Przekazywanie wartości null lub weryfikacji, która nie wymaga żadnych funkcji, spowoduje usunięcie wcześniejszej weryfikacji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
validation | CheckboxValidation | znacznika wyboru, aby zastosować go do tego elementu. |
Zwróć
CheckboxItem
– ten CheckboxItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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ę "other". Wartością domyślną w nowych CheckboxItem
lub MultipleChoiceItem
jest false
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli element ma opcję &&;quot; inny; false , jeśli nie |
Zwróć
CheckboxItem
– ten CheckboxItem
do łańcucha
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms