Class GridItem

GridItem

Pozycja pytania w postaci siatki kolumn i wierszy, która umożliwia respondentowi wybranie 1 opcji na wiersz z sekwencji przycisków. Elementy można otworzyć lub utworzyć w 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

MetodaZwracany typKrótki opis
clearValidation()GridItemUsuwa wszystkie zatwierdzenia danych dla tego elementu siatki.
createResponse(responses)ItemResponseTworzy nowy element: ItemResponse dla tego elementu siatki.
duplicate()GridItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getColumns()String[]Pobiera wartości dla każdej kolumny w siatce.
getHelpText()StringPobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu do wszystkich elementów w formularzu.
getRows()String[]Pobiera wartości dla każdego wiersza w siatce.
getTitle()StringPobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).
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 elementu (czasem nazywany tekstem opisu dla 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 (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).
setValidation(validation)GridItemUstawia weryfikację danych tego elementu siatki.

Szczegółowa dokumentacja

clearValidation()

Usuwa wszystkie zatwierdzenia danych dla tego elementu siatki.

Zwróć

GridItem – ten produkt do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 dla niewymaganego pytania w siatce wskazuje, że nie ma odpowiedzi na ten wiersz. Zwraca wyjątek, jeśli którakolwiek z wartości nie pasuje do prawidłowego wyboru.

Parametry

NazwaTypOpis
responsesString[]tablica prawidłowych odpowiedzi dla tego elementu siatki

Zwróć

ItemResponse – odpowiedź elementu;

Autoryzacja

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

Zwróć

GridItem – duplikat pytania „GridItem” dotyczący łańcucha

Autoryzacja

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

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

getColumns()

Pobiera wartości dla każdej kolumny w siatce.

Zwróć

String[] – tablica wartości kolumn, które ankietowani widzą jako etykiety podczas przeglądania formularza;

Autoryzacja

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

Zwróć

String – tekst pomocy lub opis elementu;

Autoryzacja

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

Zwróć

Integer – identyfikator elementu;

Autoryzacja

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

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

getIndex()

Pobiera indeks elementu do wszystkich elementów w formularzu.

Zwróć

Integer – indeks elementu

Autoryzacja

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

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

getRows()

Pobiera wartości dla każdego wiersza w siatce.

Zwróć

String[] – tablica wartości wierszy, które ankietowani widzą jako etykiety podczas przeglądania formularza;

Autoryzacja

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

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

getTitle()

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

Zwróć

String – tytuł lub tekst nagłówka;

Autoryzacja

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

Zwróć

ItemType – typ produktu

Autoryzacja

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

Zwróć

Boolean – czy użytkownik musi odpowiedzieć na pytanie;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 podany tablica jest pusty.

Parametry

NazwaTypOpis
columnsString[]tablica wartości kolumn, które ankietowani widzą jako etykiety podczas przeglądania formularza;

Zwróć

GridItem – ten produkt do łańcucha

Narzuty

Error – jeśli podana tablica jest null lub pusta

Autoryzacja

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

Parametry

NazwaTypOpis
textStringnowy tekst pomocy

Zwróć

GridItem – ten GridItem do łańcucha

Autoryzacja

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

Zwróć

GridItem – bieżący element (łańcuch)

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu 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 dana tablica jest pusta.

Parametry

NazwaTypOpis
rowsString[]tablica wartości wierszy, które ankietowani widzą jako etykiety podczas przeglądania formularza;

Zwróć

GridItem – ten produkt do łańcucha

Narzuty

Error – jeśli podana tablica jest null lub pusta

Autoryzacja

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

Parametry

NazwaTypOpis
titleStringnowego tytułu lub tekstu nagłówka,

Zwróć

GridItem – ten GridItem do łańcucha

Autoryzacja

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

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

setValidation(validation)

Ustawia weryfikację danych tego elementu siatki. Przekazywanie wartości null lub weryfikacji, która nie wymaga żadnych funkcji, spowoduje usunięcie wcześniejszej weryfikacji.

Parametry

NazwaTypOpis
validationGridValidationGridValidation, który ma być zastosowany do tego elementu.

Zwróć

GridItem – ten GridItem do łańcucha

Autoryzacja

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

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