Class GridItem

GridItem

Pytanie w formie siatki kolumn i wierszy, które umożliwia respondentowi wybranie jednej odpowiedzi w każdym wierszu z ciągu przycisków opcji. Dostęp do elementów można uzyskać lub tworzyć je z poziomu Form.

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 sprawdzanie poprawności danych w tym elemencie siatki.
createResponse(responses)	ItemResponse	Tworzy nowy 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 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 wśród wszystkich elementów w formularzu.
getRows()	String[]	Pobiera wartości z każdego wiersza w siatce.
getTitle()	String	Pobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()	ItemType	Pobiera typ elementu reprezentowany jako ItemType.
isRequired()	Boolean	Określa, czy respondent musi odpowiedzieć na pytanie.
setColumns(columns)	GridItem	Ustawia kolumny siatki na podstawie tablicy wartości.
setHelpText(text)	GridItem	Ustawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setRequired(enabled)	GridItem	Określa, czy respondent musi odpowiedzieć na pytanie.
setRows(rows)	GridItem	Ustawia wiersze siatki na podstawie tablicy wartości.
setTitle(title)	GridItem	Ustawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setValidation(validation)	GridItem	Ustawia sprawdzanie poprawności danych dla tego elementu siatki.

Szczegółowa dokumentacja

clearValidation()

Usuwa sprawdzanie poprawności danych w tym elemencie siatki.

Powrót

GridItem – ten element, do łączenia w łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

createResponse(responses)

Tworzy nowy ItemResponse dla tego elementu siatki. Argument responses musi być tablicą String[] zawierającą tyle wartości, ile jest wierszy w siatce. Element null w przypadku niewymaganego pytania z tabeli oznacza brak odpowiedzi w tym wierszu. Zwraca wyjątek, jeśli któraś z wartości nie pasuje do prawidłowego wyboru.

Parametry

Nazwa	Typ	Opis
responses	String[]	tablica prawidłowych odpowiedzi dla tego elementu siatki.

Powrót

ItemResponse – odpowiedź dotycząca elementu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

GridItem – duplikat tego GridItem do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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óre respondenci widzą jako etykiety podczas wyświetlania formularza.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy lub opis produktu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

Integer – identyfikator produktu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getIndex()

Pobiera indeks elementu wśród wszystkich elementów w formularzu.

Powrót

Integer – indeks elementu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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.

Powrót

String[] – tablica wartości wierszy, które respondenci widzą jako etykiety podczas wyświetlania formularza.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getTitle()

Pobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Powrót

String – tytuł lub tekst nagłówka produktu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getType()

Pobiera typ elementu reprezentowany jako ItemType.

Powrót

ItemType – typ produktu

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

Boolean – czy respondent musi odpowiedzieć na pytanie;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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. Zwraca wyjątek, jeśli podana tablica jest pusta.

Parametry

Nazwa	Typ	Opis
columns	String[]	tablica wartości kolumn, które respondenci widzą jako etykiety podczas wyświetlania formularza;

Powrót

GridItem – ten element, do łączenia w łańcuch

Rzuty

Error – jeśli podana tablica to null lub jest pusta.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 dotyczący 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,

Powrót

GridItem – ten GridItem, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 respondent musi odpowiedzieć na pytanie;

Powrót

GridItem – bieżący element (do łączenia);

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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. Zwraca wyjątek, jeśli podana tablica jest pusta.

Parametry

Nazwa	Typ	Opis
rows	String[]	tablica wartości wierszy, które respondenci widzą jako etykiety podczas wyświetlania formularza;

Powrót

GridItem – ten element, do łączenia w łańcuch

Rzuty

Error – jeśli podana tablica to null lub jest pusta.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Parametry

Nazwa	Typ	Opis
title	String	nowy tytuł lub tekst nagłówka;

Powrót

GridItem – ten GridItem, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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. Przekazanie wartości null lub instancji GridValidation, w której nie wywołano żadnych funkcji wymaganych do weryfikacji, usuwa wszelkie wcześniejsze weryfikacje.

Parametry

Nazwa	Typ	Opis
validation	GridValidation	obiekt GridValidation, który ma być zastosowany do tego elementu.

Powrót

GridItem – ten GridItem, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms