Element pytania, który pozwala respondentowi zaznaczyć co najmniej jedno pole wyboru oraz
opcjonalnie „inne” . Elementy można otwierać i tworzyć na koncie Form
. Zastosowanie
są oceniane automatycznie.
// 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 | Powoduje usunięcie sprawdzania poprawności danych tego elementu pola wyboru. |
createChoice(value) | Choice | Tworzy nową opcję. |
createChoice(value, isCorrect) | Choice | Tworzy nową opcję. |
createResponse(responses) | ItemResponse | Tworzy nowy element ItemResponse dla tego elementu wyboru. |
duplicate() | CheckboxItem | Tworzy kopię tego elementu i dołącza ją na końcu formularza. |
getChoices() | Choice[] | Pobiera wszystkie opcje dotyczące elementu. |
getFeedbackForCorrect() | QuizFeedback | Zwraca informację zwrotną, która wyświetla się użytkownikom, gdy udzielili prawidłowej odpowiedzi na pytanie. |
getFeedbackForIncorrect() | QuizFeedback | Zwraca informację zwrotną, która jest wyświetlana użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie. |
getHelpText() | String | Pobiera tekst pomocy dotyczący elementu (nazywany czasem opisem 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 w formularzu. |
getPoints() | Integer | Zwraca wartość punktową elementu podlegającego ocenie. |
getTitle() | String | Pobiera tytuł elementu (w przypadku SectionHeaderItem nazywany tekstem nagłówka). |
getType() | ItemType | Pobiera typ elementu reprezentowany przez ItemType . |
hasOtherOption() | Boolean | Określa, czy element ma atrybut „inne” . |
isRequired() | Boolean | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setChoiceValues(values) | CheckboxItem | Ustawia opcje elementu na podstawie tablicy ciągów znaków. |
setChoices(choices) | CheckboxItem | Ustawia tablicę opcji elementu. |
setFeedbackForCorrect(feedback) | CheckboxItem | Ustawia informację, że odpowiedzi będą wyświetlane użytkownikom, gdy odpowiedzą prawidłowo na pytanie. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Określa, że odpowiedź na pytanie jest wyświetlana użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie. |
setHelpText(text) | CheckboxItem | Ustawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
setPoints(points) | CheckboxItem | Określa liczbę punktów wartą oceniany element. |
setRequired(enabled) | CheckboxItem | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setTitle(title) | CheckboxItem | Określa tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka). |
setValidation(validation) | CheckboxItem | Określa sprawdzanie poprawności danych dla tego elementu pola wyboru. |
showOtherOption(enabled) | CheckboxItem | Określa, czy element ma atrybut „inne” . |
Szczegółowa dokumentacja
clearValidation()
Powoduje usunięcie sprawdzania poprawności danych tego elementu pola wyboru.
Powrót
CheckboxItem
– CheckboxItem
, łańcuch
Autoryzacja
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)
Tworzy nową opcję.
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza |
Powrót
Choice
– nowa opcja
Autoryzacja
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ę.
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | String | wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza |
isCorrect | Boolean | czy wybrana odpowiedź jest poprawna |
Powrót
Choice
– nowa opcja
Autoryzacja
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(responses)
Tworzy nowy element ItemResponse
dla tego elementu wyboru. Argument responses
to
Tablica String[]
zawierająca wartości, które należy sprawdzić. Zgłasza wyjątek, jeśli istnieje
Wartość nie pasuje do prawidłowej opcji wyboru dla tego produktu, chyba że atrybut showOtherOption(enabled)
ma wartość true
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
responses | String[] | tablica poprawnych odpowiedzi na ten element jednokrotnego wyboru |
Powrót
ItemResponse
– odpowiedź dotycząca produktu,
Autoryzacja
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.
Powrót
CheckboxItem
– duplikat kodu CheckboxItem
, na potrzeby tworzenia łańcuchów;
Autoryzacja
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 informację zwrotną, która wyświetla się użytkownikom, gdy udzielili prawidłowej odpowiedzi na pytanie.
Powrót
QuizFeedback
– ewentualne opinie.
Autoryzacja
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 informację zwrotną, która jest wyświetlana użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.
Powrót
QuizFeedback
– ewentualne opinie.
Autoryzacja
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 (nazywany czasem opisem w przypadku elementów układu takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Powrót
String
– tekst pomocy dotyczący produktu lub opis.
Autoryzacja
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.
Powrót
Integer
– identyfikator produktu,
Autoryzacja
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 w formularzu.
Powrót
Integer
– indeks elementu,
Autoryzacja
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.
Powrót
Integer
– liczba punktów warte dane pytanie.
Autoryzacja
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 SectionHeaderItem
nazywany tekstem nagłówka).
Powrót
String
– tytuł lub tekst nagłówka elementu;
Autoryzacja
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 element ma atrybut „inne” .
Powrót
Boolean
– true
, jeśli element ma wartość „inny” opcja; false
, jeśli nie
Autoryzacja
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.
Powrót
Boolean
– czy użytkownik musi odpowiedzieć na pytanie.
Autoryzacja
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 na podstawie tablicy ciągów znaków. Zgłasza wyjątek, jeśli dana tablica jest puste.
// 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[] | tablicę wartości wyboru, którą respondenci widzą jako etykiety podczas przeglądania formularza |
Powrót
CheckboxItem
– CheckboxItem
, łańcuch
Autoryzacja
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 elementu. Zgłasza 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 |
Powrót
CheckboxItem
– CheckboxItem
, łańcuch
Rzuty
Error
– jeśli dana tablica jest null
, pusta lub zawiera element null
,
Autoryzacja
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)
Ustawia informację, że odpowiedzi będą wyświetlane użytkownikom, gdy odpowiedzą prawidłowo 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 | nowych opinii. Wartość null usuwa informację zwrotną. |
Powrót
CheckboxItem
– CheckboxItem
, łańcuch
Autoryzacja
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, że odpowiedź na pytanie jest wyświetlana użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
feedback | QuizFeedback | nowa opinia |
Powrót
CheckboxItem
– CheckboxItem
, łańcuch
Autoryzacja
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 elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy |
Powrót
CheckboxItem
– CheckboxItem
, łańcuch
Autoryzacja
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 wartą oceniany element. Wartość domyślna nowych elementów to 0.
Parametry
Nazwa | Typ | Opis |
---|---|---|
points | Integer | liczba punktów warta przedmiot pytania |
Powrót
CheckboxItem
– CheckboxItem
, łańcuch
Autoryzacja
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, |
Powrót
CheckboxItem
– bieżący element (do tworzenia łańcuchów),
Autoryzacja
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)
Określa tytuł elementu (w przypadku SectionHeaderItem
nazywany też tekstem nagłówka).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka; |
Powrót
CheckboxItem
– CheckboxItem
, łańcuch
Autoryzacja
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
setValidation(validation)
Określa sprawdzanie poprawności danych dla tego elementu pola wyboru. Wartość null lub weryfikacja bez wartości wymaga wywołania funkcji, co spowoduje usunięcie wcześniejszej weryfikacji.
Parametry
Nazwa | Typ | Opis |
---|---|---|
validation | CheckboxValidation | pole CheckboxValidation, które ma zostać zastosowane do tego elementu. |
Powrót
CheckboxItem
– CheckboxItem
, łańcuch
Autoryzacja
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 element ma atrybut „inne” . Ustawienie domyślne dla nowego modelu CheckboxItem
lub
MultipleChoiceItem
– false
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | true , jeśli element ma wartość „inne” opcja; false , jeśli nie |
Powrót
CheckboxItem
– CheckboxItem
, łańcuch
Autoryzacja
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