Class GridItem

Элемент сетки

Элемент вопроса, представленный в виде сетки столбцов и строк, позволяющий респонденту выбрать один вариант ответа в каждой строке из последовательности переключателей. Доступ к элементам можно получить или создать из 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']);

Методы

Метод Тип возврата Краткое описание
clear Validation() Grid Item Удаляет любую проверку данных для этого элемента сетки.
create Response(responses) Item Response Создает новый Item Response для этого элемента сетки.
duplicate() Grid Item Создает копию этого элемента и добавляет ее в конец формы.
get Columns() String[] Получает значения для каждого столбца в сетке.
get Help Text() String Получает текст справки элемента (иногда называемый текстом описания для элементов макета, таких как Image Items , Page Break Items и Section Header Items ).
get Id() Integer Получает уникальный идентификатор элемента.
get Index() Integer Получает индекс элемента среди всех элементов в форме.
get Rows() String[] Получает значения для каждой строки в сетке.
get Title() String Получает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ).
get Type() Item Type Возвращает тип элемента, представленный как Item Type .
is Required() Boolean Определяет, должен ли респондент отвечать на вопрос.
set Columns(columns) Grid Item Устанавливает столбцы сетки на основе массива значений.
set Help Text(text) Grid Item Задает текст справки элемента (иногда называемый текстом описания для элементов макета, таких как Image Items , Page Break Items и Section Header Items ).
set Required(enabled) Grid Item Устанавливает, должен ли респондент отвечать на вопрос.
set Rows(rows) Grid Item Устанавливает строки сетки на основе массива значений.
set Title(title) Grid Item Задает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ).
set Validation(validation) Grid Item Устанавливает проверку данных для этого элемента сетки.

Подробная документация

clear Validation()

Удаляет любую проверку данных для этого элемента сетки.

Возвращаться

Grid Item — этот элемент, для объединения в цепочку

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

create Response(responses)

Создаёт новый Item Response для данного элемента сетки. Аргумент responses должен быть массивом String[] содержащим столько же значений, сколько строк в сетке. null элемент для необязательного вопроса сетки указывает на отсутствие ответа на эту строку. Вызывает исключение, если какое-либо из значений не соответствует допустимому варианту ответа.

Параметры

Имя Тип Описание
responses String[] массив допустимых ответов для этого элемента сетки

Возвращаться

Item Response — ответ на элемент

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

duplicate()

Создает копию этого элемента и добавляет ее в конец формы.

Возвращаться

Grid Item — дубликат этого Grid Item для объединения в цепочку

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

get Columns()

Получает значения для каждого столбца в сетке.

Возвращаться

String[] — массив значений столбцов, которые респонденты видят как метки при просмотре формы

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

get Help Text()

Получает текст справки элемента (иногда называемый текстом описания для элементов макета, таких как Image Items , Page Break Items и Section Header Items ).

Возвращаться

String — текст справки или описания элемента.

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

get Id()

Получает уникальный идентификатор элемента.

Возвращаться

Integer — идентификатор элемента

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

get Index()

Получает индекс элемента среди всех элементов в форме.

Возвращаться

Integer — индекс элемента

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

get Rows()

Получает значения для каждой строки в сетке.

Возвращаться

String[] — массив значений строк, которые респонденты видят как метки при просмотре формы

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

get Title()

Получает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ).

Возвращаться

String — текст заголовка или заголовка элемента.

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

get Type()

Возвращает тип элемента, представленный как Item Type .

Возвращаться

Item Type — тип предмета

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

is Required()

Определяет, должен ли респондент отвечать на вопрос.

Возвращаться

Boolean — должен ли респондент ответить на вопрос

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

set Columns(columns)

Устанавливает столбцы сетки на основе массива значений. Вызывает исключение, если массив пуст.

Параметры

Имя Тип Описание
columns String[] массив значений столбцов, которые респонденты видят как метки при просмотре формы

Возвращаться

Grid Item — этот элемент, для объединения в цепочку

Броски

Error — если заданный массив равен null или пуст

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

set Help Text(text)

Задает текст справки элемента (иногда называемый текстом описания для элементов макета, таких как Image Items , Page Break Items и Section Header Items ).

Параметры

Имя Тип Описание
text String новый текст справки

Возвращаться

Grid Item — этот Grid Item , для объединения в цепочку

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

set Required(enabled)

Устанавливает, должен ли респондент отвечать на вопрос.

Параметры

Имя Тип Описание
enabled Boolean должен ли респондент отвечать на вопрос

Возвращаться

Grid Item — текущий элемент (для объединения в цепочку)

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

set Rows(rows)

Устанавливает строки сетки на основе массива значений. Вызывает исключение, если массив пуст.

Параметры

Имя Тип Описание
rows String[] массив значений строк, которые респонденты видят как метки при просмотре формы

Возвращаться

Grid Item — этот элемент, для объединения в цепочку

Броски

Error — если заданный массив равен null или пуст

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

set Title(title)

Задает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ).

Параметры

Имя Тип Описание
title String новый текст заголовка или заголовка

Возвращаться

Grid Item — этот Grid Item , для объединения в цепочку

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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

set Validation(validation)

Устанавливает проверку данных для этого элемента сетки. Передача значения null или экземпляра Grid Validation для которого не вызывались функции require, отменяет любую предыдущую проверку.

Параметры

Имя Тип Описание
validation Grid Validation GridValidation для применения к этому элементу.

Возвращаться

Grid Item — этот Grid Item , для объединения в цепочку

Авторизация

Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :

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