Class GridItem

GridItem

Element pytania, przedstawiony jako siatka kolumn i wierszy, który umożliwia respondentowi wybranie tej opcji jedną opcję do wyboru w wierszu, wybierając jeden z szeregu przycisków opcji. Elementy można otwierać i tworzyć 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()GridItemPowoduje usunięcie sprawdzania poprawności danych w tym elemencie 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 z każdej kolumny w siatce.
getHelpText()StringPobiera tekst pomocy dotyczący elementu (nazywany czasem opisem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getRows()String[]Pobiera wartości z każdego wiersza siatki.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu reprezentowany przez ItemType.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setColumns(columns)GridItemUstawia kolumny siatki na podstawie tablicy wartości.
setHelpText(text)GridItemUstawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setRequired(enabled)GridItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setRows(rows)GridItemUstawia wiersze siatki na podstawie tablicy wartości.
setTitle(title)GridItemOkreśla tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka).
setValidation(validation)GridItemUstawia sprawdzanie poprawności danych dla tego elementu siatki.

Szczegółowa dokumentacja

clearValidation()

Powoduje usunięcie sprawdzania poprawności danych w tym elemencie siatki.

Powrót

GridItem – ten element do tworzenia łańcuchów,

Autoryzacja

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ć wartością Tablica String[] zawierająca tyle wartości, ile jest wierszy w siatce. Element null w niewymaganym pytaniu z siatki oznacza brak odpowiedzi w danym wierszu. Wyrzuca w sytuacji, gdy którakolwiek z wartości nie pasuje do prawidłowej odpowiedzi.

Parametry

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

Powrót

ItemResponse – odpowiedź dotycząca produktu,

Autoryzacja

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.

Powrót

GridItem – duplikat kodu GridItem, na potrzeby tworzenia łańcuchów;

Autoryzacja

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.

Powrót

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

Autoryzacja

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 (nazywany czasem opisem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy dotyczący produktu lub opis.

Autoryzacja

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.

Powrót

Integer – identyfikator produktu,

Autoryzacja

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 w formularzu.

Powrót

Integer – indeks elementu,

Autoryzacja

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 siatki.

Powrót

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

Autoryzacja

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 SectionHeaderItem nazywany tekstem nagłówka).

Powrót

String – tytuł lub tekst nagłówka elementu;

Autoryzacja

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()

Pobiera typ elementu reprezentowany przez ItemType.

Powrót

ItemType – typ elementu,

Autoryzacja

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

isRequired()

Określa, czy użytkownik musi odpowiedzieć na pytanie.

Powrót

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

Autoryzacja

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. Zgłasza wyjątek, jeśli dane tablica jest pusta.

Parametry

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

Powrót

GridItem – ten element do tworzenia łańcuchów,

Rzuty

Error – jeśli dana tablica ma wartość null lub jest pusta

Autoryzacja

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 elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

NazwaTypOpis
textStringnowy tekst pomocy

Powrót

GridItemGridItem, łańcuch

Autoryzacja

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

NazwaTypOpis
enabledBooleanczy respondent musi odpowiedzieć na pytanie,

Powrót

GridItem – bieżący element (do tworzenia łańcuchów),

Autoryzacja

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 dana tablica jest puste.

Parametry

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

Powrót

GridItem – ten element do tworzenia łańcuchów,

Rzuty

Error – jeśli dana tablica ma wartość null lub jest pusta

Autoryzacja

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)

Określa tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka).

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka;

Powrót

GridItemGridItem, łańcuch

Autoryzacja

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. Wartość null lub weryfikacja bez wartości wymaga wywołania funkcji, co spowoduje usunięcie wcześniejszej weryfikacji.

Parametry

NazwaTypOpis
validationGridValidationwartość GridValidation, która ma zostać zastosowana do tego elementu.

Powrót

GridItemGridItem, łańcuch

Autoryzacja

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