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

MetodaZwracany typKrótki opis
clearValidation()GridItemUsuwa sprawdzanie poprawności danych w tym elemencie siatki.
createResponse(responses)ItemResponseTworzy nowy ItemResponse dla tego elementu siatki.
duplicate()GridItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getColumns()String[]Pobiera wartości z każdej kolumny w siatce.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu wśród wszystkich elementów w formularzu.
getRows()String[]Pobiera wartości z każdego wiersza w siatce.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu reprezentowany jako ItemType.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setColumns(columns)GridItemUstawia kolumny siatki na podstawie tablicy wartości.
setHelpText(text)GridItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setRequired(enabled)GridItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setRows(rows)GridItemUstawia wiersze siatki na podstawie tablicy wartości.
setTitle(title)GridItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setValidation(validation)GridItemUstawia 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

NazwaTypOpis
responsesString[]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

NazwaTypOpis
columnsString[]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

NazwaTypOpis
textStringnowy 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

NazwaTypOpis
enabledBooleanczy 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

NazwaTypOpis
rowsString[]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

NazwaTypOpis
titleStringnowy 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

NazwaTypOpis
validationGridValidationobiekt 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