Class CheckboxGridItem

Элемент сетки флажка

Элемент вопроса, представленный в виде сетки столбцов и строк, который позволяет респонденту выбирать несколько вариантов ответа в каждой строке из последовательности флажков. К элементам можно получить доступ или создать их из 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()

Получает тип элемента, представленный как 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[] массив значений столбцов, которые респонденты видят как метки при просмотре формы

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

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