Element pytania, przedstawiony jako siatka kolumn i wierszy, który umożliwia respondentowi wybranie tej opcji
wiele opcji wyboru na wiersz z sekwencji pól wyboru. Elementy można otwierać i tworzyć w
Form
// Open a form by ID and add a new checkbox grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
.setRows(['New York', 'San Francisco', 'London'])
.setColumns(['2014', '2015', '2016', '2017']);
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
clearValidation() | CheckboxGridItem | Powoduje usunięcie sprawdzania poprawności danych w tym elemencie siatki. |
createResponse(responses) | ItemResponse | Tworzy nowy element ItemResponse dla tego elementu siatki z polem wyboru. |
duplicate() | CheckboxGridItem | Tworzy kopię tego elementu i dołącza ją na końcu formularza. |
getColumns() | String[] | Pobiera wartości z każdej kolumny w siatce. |
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. |
getRows() | String[] | Pobiera wartości z każdego wiersza siatki. |
getTitle() | String | Pobiera tytuł elementu (w przypadku SectionHeaderItem nazywany tekstem nagłówka). |
getType() | ItemType | Pobiera typ elementu reprezentowany przez ItemType. |
isRequired() | Boolean | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setColumns(columns) | CheckboxGridItem | Ustawia kolumny siatki na podstawie tablicy wartości. |
setHelpText(text) | CheckboxGridItem | Ustawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems). |
setRequired(enabled) | CheckboxGridItem | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setRows(rows) | CheckboxGridItem | Ustawia wiersze siatki na podstawie tablicy wartości. |
setTitle(title) | CheckboxGridItem | Określa tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka). |
setValidation(validation) | CheckboxGridItem | Ustawia sprawdzanie poprawności danych dla tego elementu siatki z polem wyboru. |
Szczegółowa dokumentacja
clearValidation()
Powoduje usunięcie sprawdzania poprawności danych w tym elemencie siatki.
Powrót
CheckboxGridItem – ten 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
createResponse(responses)
Tworzy nowy element ItemResponse dla tego elementu siatki z polem wyboru. Argument responses
musi być tablicą String[][] zawierającą tablice zawierające tyle wartości, ile danych wejściowych
w siatce pól wyboru. Element null niewymaganego pytania z siatką pól wyboru
oznacza brak odpowiedzi na dany wiersz. Zgłasza wyjątek, jeśli którakolwiek z wartości nie jest zgodna z
poprawny wybór.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
responses | String[][] | tablica tablic z prawidłowymi odpowiedziami dla tego elementu siatki z polem 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
CheckboxGridItem – duplikat kodu CheckboxGridItem, 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
getColumns()
Pobiera wartości z każdej kolumny w siatce.
Powrót
String[] – tablica wartości kolumn, którą respondenci widzą jako etykiety podczas wyświetlania formularza
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
getRows()
Pobiera wartości z każdego wiersza siatki.
Powrót
String[] – tablica wartości wierszy, którą ankietowani widzą jako etykiety podczas wyświetlania formularza
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()
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
setColumns(columns)
Ustawia kolumny siatki na podstawie tablicy wartości. Zgłasza wyjątek, jeśli dane tablica jest pusta.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
columns | String[] | tablica wartości kolumn, którą respondenci widzą jako etykiety podczas przeglądania formularza |
Powrót
CheckboxGridItem – ten element do tworzenia łańcuchów,
Rzuty
Error – jeśli dana tablica ma wartość null lub jest pusta
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
CheckboxGridItem – CheckboxGridItem, ł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
CheckboxGridItem – 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
setRows(rows)
Ustawia wiersze siatki na podstawie tablicy wartości. Zgłasza wyjątek, jeśli dana tablica jest puste.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
rows | String[] | tablica wartości wierszy, którą respondenci widzą jako etykiety podczas przeglądania formularza |
Powrót
CheckboxGridItem – ten element do tworzenia łańcuchów,
Rzuty
Error – jeśli dana tablica ma wartość null lub jest pusta
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
CheckboxGridItem – CheckboxGridItem, ł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)
Ustawia sprawdzanie poprawności danych dla tego elementu siatki z polem wyboru. Wartość null lub weryfikacja bez wartości wszystkich wywołań wymaganych funkcji spowoduje usunięcie wcześniejszej weryfikacji.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
validation | CheckboxGridValidation | pole CheckboxGridValidation, które ma zostać zastosowane do tego elementu. |
Powrót
CheckboxGridItem – CheckboxGridItem, ł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