Class GridItem

GridItem

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