Pozycja pytania przedstawiona w postaci siatki kolumn i wierszy, która umożliwia respondentom wybranie w każdym wierszu jednej opcji z sekwencji przycisków opcji. Elementy można otworzyć lub utworzyć za pomocą: Form.
// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addGridItem();
item.setTitle('Rate your interests')
.setRows(['Cars', 'Computers', 'Celebrities'])
.setColumns(['Boring', 'So-so', 'Interesting']);
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
clearValidation() | GridItem | Usuwa wszystkie reguły sprawdzania poprawności danych związane z tym elementem siatki. |
createResponse(responses) | ItemResponse | Tworzy nowy element ItemResponse dla tego elementu siatki. |
duplicate() | GridItem | 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 (czasami nazywany tekstem opisu 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 formularza. |
getRows() | String[] | Pobiera wartości z każdego wiersza w siatce. |
getTitle() | String | Pobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
getType() | ItemType | Pobiera typ elementu, reprezentowany jako ItemType. |
isRequired() | Boolean | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setColumns(columns) | GridItem | Ustawia kolumny siatki na podstawie tablicy wartości. |
setHelpText(text) | GridItem | Ustawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems). |
setRequired(enabled) | GridItem | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setRows(rows) | GridItem | Ustawia wiersze siatki na podstawie tablicy wartości. |
setTitle(title) | GridItem | Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
setValidation(validation) | GridItem | Ustawia sprawdzanie poprawności danych dla tego elementu siatki. |
Szczegółowa dokumentacja
clearValidation()
Usuwa wszystkie reguły sprawdzania poprawności danych związane z tym elementem siatki.
Powroty
GridItem – ten element do wiązania w łańcuchach
Upoważnienie
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. Argument responses musi być tablicą String[] zawierającą tyle wartości, ile wynosi liczba wierszy w siatce. W przypadku niewymaganego pytania siatki element null wskazuje na brak odpowiedzi na ten wiersz. Zwraca wyjątek, jeśli dowolna z wartości nie pasuje do prawidłowej opcji.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
responses | String[] | tablica prawidłowych odpowiedzi dla tego elementu siatki |
Powroty
ItemResponse – odpowiedź dotycząca produktu,
Upoważnienie
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.
Powroty
GridItem – duplikat elementu GridItem na potrzeby łańcuchów
Upoważnienie
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.
Powroty
String[] – tablica wartości kolumn, które użytkownicy widzą jako etykiety podczas wyświetlania formularza.
Upoważnienie
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 (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
Powroty
String – tekst pomocy lub opis dotyczący produktu.
Upoważnienie
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.
Powroty
Integer – identyfikator produktu,
Upoważnienie
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 formularza.
Powroty
Integer – indeks elementu;
Upoważnienie
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 w siatce.
Powroty
String[] – tablica wartości wierszy, które użytkownicy widzą jako etykiety podczas wyświetlania formularza.
Upoważnienie
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 elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
Powroty
String – tytuł lub tekst nagłówka elementu;
Upoważnienie
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.
Powroty
Boolean – czy użytkownik musi odpowiedzieć na pytanie;
Upoważnienie
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. Jeśli dana tablica jest pusta, zgłasza wyjątek.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
columns | String[] | tablicę wartości kolumn, które użytkownicy widzą jako etykiety podczas wyświetlania formularza. |
Powroty
GridItem – ten element do wiązania w łańcuchach
Rzuty
Error – jeśli tablica jest pusta lub null
Upoważnienie
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 dotyczącej 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 |
Powroty
GridItem – ten GridItem, do łańcuchów
Upoważnienie
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, |
Powroty
GridItem – bieżący element (na potrzeby łańcuszków)
Upoważnienie
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 podana tablica jest pusta.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
rows | String[] | tablicę wartości wierszy, które użytkownicy widzą jako etykiety podczas wyświetlania formularza. |
Powroty
GridItem – ten element do wiązania w łańcuchach
Rzuty
Error – jeśli tablica jest pusta lub null
Upoważnienie
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)
Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
title | String | nowy tytuł lub tekst nagłówka. |
Powroty
GridItem – ten GridItem, do łańcuchów
Upoważnienie
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. Przejście na wartość null lub weryfikację bez wywoływania żadnych funkcji wymagających usunięcia spowoduje usunięcie wcześniejszej weryfikacji.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
validation | GridValidation | a GridValidation, które ma zostać zastosowane do tego elementu. |
Powroty
GridItem – ten GridItem, do łańcuchów
Upoważnienie
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