Вопрос, представленный в виде сетки столбцов и строк, позволяет респонденту выбрать один вариант ответа в каждой строке из последовательности радиокнопок. Доступ к вопросам или их создание возможны через 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 | Задает параметры проверки данных для данного элемента таблицы. |
Подробная документация
clearValidation()
Удаляет проверку данных для этого элемента таблицы.
Возвращаться
GridItem — этот элемент для создания цепочек
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
createResponse(responses)
Создает новый объект ItemResponse для этого элемента сетки. Аргумент responses должен представлять собой массив String[] , содержащий столько значений, сколько строк в сетке. null элемент для необязательного вопроса в сетке указывает на отсутствие ответа на эту строку. Генерирует исключение, если какое-либо из значений не соответствует допустимому варианту выбора.
Параметры
| Имя | Тип | Описание |
|---|---|---|
responses | String[] | массив допустимых ответов для этого элемента таблицы |
Возвращаться
ItemResponse — ответ на запрос товара
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
duplicate()
Создает копию этого элемента и добавляет ее в конец формы.
Возвращаться
GridItem — дубликат этого GridItem для создания цепочек вызовов.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getColumns()
Получает значения для каждого столбца в таблице.
Возвращаться
String[] — массив значений столбцов, которые респонденты видят в качестве меток при просмотре формы.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getHelpText()
Получает справочный текст элемента (иногда называемый описательным текстом для элементов макета, таких как ImageItems , PageBreakItems и SectionHeaderItems ).
Возвращаться
String — текст справки или описания элемента.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
Получает уникальный идентификатор элемента.
Возвращаться
Integer — идентификатор товара.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getIndex()
Получает индекс элемента среди всех элементов в форме.
Возвращаться
Integer — индекс элемента
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getRows()
Получает значения для каждой строки в таблице.
Возвращаться
String[] — массив значений строк, которые респонденты видят в качестве меток при просмотре формы.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
Получает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).
Возвращаться
String — заголовок или подзаголовок элемента
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
Получает тип элемента, представленный в виде объекта ItemType .
Возвращаться
ItemType — тип товара
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
isRequired()
Определяет, обязан ли респондент ответить на вопрос.
Возвращаться
Boolean — указывает, должен ли респондент ответить на вопрос.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setColumns(columns)
Задает столбцы сетки на основе массива значений. Генерирует исключение, если заданный массив пуст.
Параметры
| Имя | Тип | Описание |
|---|---|---|
columns | String[] | массив значений столбцов, которые респонденты видят в виде меток при просмотре формы. |
Возвращаться
GridItem — этот элемент для создания цепочек
Броски
Error — если заданный массив равен null или пуст.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
Задает текст справки для элемента (иногда называемый текстом описания для элементов макета, таких как ImageItems , PageBreakItems и SectionHeaderItems ).
Параметры
| Имя | Тип | Описание |
|---|---|---|
text | String | новый текст справки |
Возвращаться
GridItem — этот GridItem для создания цепочек
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setRequired(enabled)
Определяет, обязан ли респондент ответить на вопрос.
Параметры
| Имя | Тип | Описание |
|---|---|---|
enabled | Boolean | должен ли респондент ответить на этот вопрос? |
Возвращаться
GridItem — текущий элемент (для создания цепочек)
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setRows(rows)
Задает строки сетки на основе массива значений. Генерирует исключение, если заданный массив пуст.
Параметры
| Имя | Тип | Описание |
|---|---|---|
rows | String[] | массив значений строк, которые респонденты видят в виде меток при просмотре формы. |
Возвращаться
GridItem — этот элемент для создания цепочек
Броски
Error — если заданный массив равен null или пуст.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
Задает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).
Параметры
| Имя | Тип | Описание |
|---|---|---|
title | String | новый заголовок или подзаголовочный текст |
Возвращаться
GridItem — этот GridItem для создания цепочек
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setValidation(validation)
Задает проверку данных для этого элемента таблицы. Передача значения null или экземпляра GridValidation , для которого не были вызваны функции require, отменяет любую предыдущую проверку.
Параметры
| Имя | Тип | Описание |
|---|---|---|
validation | Grid Validation | Параметр GridValidation, который будет применен к этому элементу. |
Возвращаться
GridItem — этот GridItem для создания цепочек
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms