Class CheckboxGridItem

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
CheckboxGridItem

Элемент вопроса, представленный в виде сетки столбцов и строк, который позволяет респонденту выбрать несколько вариантов ответа в строке из последовательности флажков. Элементы могут быть доступны или созданы из Form .

// Open a form by ID and add a new checkgox grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
  .setRows(['New York', 'San Francisco', 'London'])
  .setColumns(['2014', '2015', '2016', '2017']);

Методы

Метод Тип возврата Краткое описание
clearValidation() CheckboxGridItem Удаляет любую проверку данных для этого элемента сетки.
createResponse(responses) ItemResponse Создает новый ItemResponse для этого элемента сетки флажков.
duplicate() CheckboxGridItem Создает копию этого элемента и добавляет ее в конец формы.
getColumns() String[] Получает значения для каждого столбца в сетке.
getHelpText() String Получает текст справки элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems и SectionHeaderItems ).
getId() Integer Получает уникальный идентификатор элемента.
getIndex() Integer Получает индекс элемента среди всех элементов в форме.
getRows() String[] Получает значения для каждой строки в сетке.
getTitle() String Получает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).
getType() ItemType Получает тип элемента, представленный как ItemType .
isRequired() Boolean Определяет, должен ли респондент отвечать на вопрос.
setColumns(columns) CheckboxGridItem Задает столбцы сетки на основе массива значений.
setHelpText(text) CheckboxGridItem Задает текст справки элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems и SectionHeaderItems ).
setRequired(enabled) CheckboxGridItem Устанавливает, должен ли респондент отвечать на вопрос.
setRows(rows) CheckboxGridItem Задает строки сетки на основе массива значений.
setTitle(title) CheckboxGridItem Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).
setValidation(validation) CheckboxGridItem Задает проверку данных для этого элемента сетки флажков.

Подробная документация

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)

Задает проверку данных для этого элемента сетки флажков. Передача нулевого значения или проверки без вызова каких-либо требуемых функций удалит любую предыдущую проверку.

Параметры

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

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

CheckboxGridItem — этот CheckboxGridItem для цепочки

Авторизация

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

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