Элемент вопроса, представленный в виде сетки столбцов и строк, который позволяет респонденту выбирать несколько вариантов ответа в каждой строке из последовательности флажков. К элементам можно получить доступ или создать их из 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 | Устанавливает проверку данных для этого элемента сетки флажков. |
Подробная документация
clear Validation()
Удаляет любую проверку данных для этого элемента сетки.
Возвращаться
Checkbox 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()
Создает копию этого элемента и добавляет ее в конец формы.
Возвращаться
Checkbox Grid Item
— дубликат этого Checkbox 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()
is Required()
Определяет, должен ли респондент отвечать на вопрос.
Возвращаться
Boolean
— должен ли респондент отвечать на вопрос
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Columns(columns)
Устанавливает столбцы сетки на основе массива значений. Выдает исключение, если данный массив пуст.
Параметры
Имя | Тип | Описание |
---|---|---|
columns | String[] | массив значений столбцов, которые респонденты видят как метки при просмотре формы |
Возвращаться
Checkbox 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 | новый текст справки |
Возвращаться
Checkbox Grid Item
— этот Checkbox Grid Item
, для связывания
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Required(enabled)
Устанавливает, должен ли респондент отвечать на вопрос.
Параметры
Имя | Тип | Описание |
---|---|---|
enabled | Boolean | должен ли респондент отвечать на вопрос |
Возвращаться
Checkbox Grid Item
— текущий элемент (для цепочки)
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Rows(rows)
Устанавливает строки сетки на основе массива значений. Выдает исключение, если данный массив пуст.
Параметры
Имя | Тип | Описание |
---|---|---|
rows | String[] | массив значений строк, которые респонденты видят как метки при просмотре формы |
Возвращаться
Checkbox 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 | новый заголовок или текст заголовка |
Возвращаться
Checkbox Grid Item
— этот Checkbox Grid Item
, для связывания
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Validation(validation)
Устанавливает проверку данных для этого элемента сетки флажков. Передача значения null или проверки без вызова требуемых функций приведет к удалению любой предыдущей проверки.
Параметры
Имя | Тип | Описание |
---|---|---|
validation | Checkbox Grid Validation | CheckboxGridValidation для применения к этому элементу. |
Возвращаться
Checkbox Grid Item
— этот Checkbox Grid Item
, для связывания
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms