Эта страница переведена с помощью Cloud Translation API.

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 или проверки без вызова требуемых функций приведет к удалению любой предыдущей проверки.

Параметры

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

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

Grid Item — этот Grid Item , для цепочки

Авторизация

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

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