Class GridItem

SiatkaProdukt

Element w postaci siatki kolumn i wierszy, który umożliwia respondentowi wybranie jednej opcji na wiersz z sekwencji przycisków opcji. Elementy można tworzyć i otwierać w folderze 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 wszystkie reguły sprawdzania poprawności danych dotyczące tego elementu siatki.
createResponse(responses)	ItemResponse	Tworzy nowy element ItemResponse dla tego elementu siatki.
duplicate()	GridItem	Tworzy kopię tego elementu i dodaje 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 dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()	Integer	Pobiera unikalny identyfikator produktu.
getIndex()	Integer	Pobiera indeks elementu spośród wszystkich elementów w formularzu.
getRows()	String[]	Pobiera wartości z każdego wiersza w siatce.
getTitle()	String	Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
getType()	ItemType	Pobiera typ elementu 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 elementu (czasami nazywany tekstem opisu dla 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ł produktu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
setValidation(validation)	GridItem	Ustawia sprawdzanie poprawności danych dla tego elementu siatki.

Szczegółowa dokumentacja

clearValidation()

Usuwa wszystkie reguły sprawdzania poprawności danych dotyczące tego elementu siatki.

Powrót

GridItem – ten element, do łańcucha;

Autoryzacja

Skrypty, które korzystają 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 jest wierszy w siatce. Element null w przypadku nieobowiązkowego pytania z tabeli oznacza brak odpowiedzi w danym wierszu. Wyjątek jest rzucany, jeśli którakolwiek 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ź na element

Autoryzacja

Skrypty, które korzystają 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 dodaje ją na końcu formularza.

Powrót

GridItem – duplikat tego elementu GridItem, służący do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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óre respondenci widzą jako etykiety podczas wyświetlania formularza.

Autoryzacja

Skrypty, które korzystają 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 elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy lub tekst opisu produktu,

Autoryzacja

Skrypty, które korzystają 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 produktu.

Powrót

Integer – identyfikator produktu

Autoryzacja

Skrypty, które korzystają 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, które korzystają 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.

Powrót

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

Autoryzacja

Skrypty, które korzystają 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 (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

Powrót

String – tytuł lub tekst nagłówka

Autoryzacja

Skrypty, które korzystają 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()

Pobiera typ elementu jako ItemType.

Powrót

ItemType – typ elementu

Autoryzacja

Skrypty, które korzystają 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 respondent musi odpowiedzieć na pytanie.

Powrót

Boolean – czy respondent musi odpowiedzieć na pytanie

Autoryzacja

Skrypty, które korzystają 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. Wyjątek, jeśli podany 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 łańcucha;

Rzuty

Error – jeśli podana tablica jest tablicą null lub pusta

Autoryzacja

Skrypty, które korzystają 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 (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

Nazwa	Typ	Opis
text	String	nowy tekst pomocy.

Powrót

GridItem – ta GridItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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 respondent musi odpowiedzieć na pytanie.

Parametry

Nazwa	Typ	Opis
enabled	Boolean	czy respondent musi udzielić odpowiedzi na pytanie.

Powrót

GridItem – bieżący element (do łańcuchowania).

Autoryzacja

Skrypty, które korzystają 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. Wyjątek, jeśli podany 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 łańcucha;

Rzuty

Error – jeśli podana tablica jest tablicą null lub pusta

Autoryzacja

Skrypty, które korzystają 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ł produktu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

Parametry

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

Powrót

GridItem – ta GridItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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. Przekazanie wartości null lub walidacji bez wywołania funkcji require spowoduje usunięcie wcześniejszej walidacji.

Parametry

Nazwa	Typ	Opis
validation	GridValidation	GridValidation, które mają być stosowane do tego produktu.

Powrót

GridItem – ta GridItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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