Вопрос, представленный в виде сетки столбцов и строк, позволяет респонденту выбирать несколько вариантов ответа в каждой строке из последовательности флажков. Доступ к вопросам или их создание возможны через Form .
// Open a form by ID and add a new checkbox grid item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Years?') .setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
Методы
| Метод | Тип возвращаемого значения | Краткое описание |
|---|---|---|
clear Validation() | Checkbox Grid Item | Удаляет проверку данных для этого элемента таблицы. |
create Response(responses) | Item Response | Создает новый Item Response для этого элемента сетки с флажками. |
duplicate() | Checkbox 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) | Checkbox Grid Item | Задает столбцы сетки на основе массива значений. |
set Help Text(text) | Checkbox Grid Item | Задает текст справки для элемента (иногда называемый текстом описания для элементов макета, таких как Image Items , Page Break Items и Section Header Items ). |
set Required(enabled) | Checkbox Grid Item | Определяет, обязан ли респондент ответить на вопрос. |
set Rows(rows) | Checkbox Grid Item | Задает строки сетки на основе массива значений. |
set Title(title) | Checkbox Grid Item | Задает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ). |
set Validation(validation) | Checkbox Grid Item | Задает проверку данных для этого элемента сетки с флажками. |
Подробная документация
clearValidation()
Удаляет проверку данных для этого элемента таблицы.
Возвращаться
CheckboxGridItem — этот элемент используется для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
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()
Создает копию этого элемента и добавляет ее в конец формы.
Возвращаться
CheckboxGridItem — дубликат этого CheckboxGridItem для создания цепочек вызовов.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
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[] | массив значений столбцов, которые респонденты видят в виде меток при просмотре формы. |
Возвращаться
CheckboxGridItem — этот элемент используется для создания цепочек.
Броски
Error — если заданный массив равен null или пуст.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
Задает текст справки для элемента (иногда называемый текстом описания для элементов макета, таких как ImageItems , PageBreakItems и SectionHeaderItems ).
Параметры
| Имя | Тип | Описание |
|---|---|---|
text | String | новый текст справки |
Возвращаться
CheckboxGridItem — этот CheckboxGridItem для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setRequired(enabled)
Определяет, обязан ли респондент ответить на вопрос.
Параметры
| Имя | Тип | Описание |
|---|---|---|
enabled | Boolean | должен ли респондент ответить на этот вопрос? |
Возвращаться
CheckboxGridItem — текущий элемент (для создания цепочки)
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setRows(rows)
Задает строки сетки на основе массива значений. Генерирует исключение, если заданный массив пуст.
Параметры
| Имя | Тип | Описание |
|---|---|---|
rows | String[] | массив значений строк, которые респонденты видят в виде меток при просмотре формы. |
Возвращаться
CheckboxGridItem — этот элемент используется для создания цепочек.
Броски
Error — если заданный массив равен null или пуст.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
Задает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).
Параметры
| Имя | Тип | Описание |
|---|---|---|
title | String | новый заголовок или подзаголовочный текст |
Возвращаться
CheckboxGridItem — этот CheckboxGridItem для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setValidation(validation)
Задает проверку данных для этого элемента сетки с флажками. Передача значения null или проверки без вызова каких-либо функций require приведет к удалению любой предыдущей проверки.
Параметры
| Имя | Тип | Описание |
|---|---|---|
validation | Checkbox Grid Validation | Метод CheckboxGridValidation, который будет применен к этому элементу. |
Возвращаться
CheckboxGridItem — этот CheckboxGridItem для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms