Вопрос, позволяющий респонденту выбрать один или несколько вариантов ответа, а также добавить необязательное поле «другое». Доступ к вопросам можно получить или создать через Form . При использовании в викторине эти вопросы оцениваются автоматически.
// Open a form by ID and add a new checkbox item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish'), ]) .showOtherOption(true);
Методы
| Метод | Тип возвращаемого значения | Краткое описание |
|---|---|---|
clear Validation() | Checkbox Item | Удаляет проверку данных для этого флажка. |
create Choice(value) | Choice | Создает новый вариант выбора. |
create Choice(value, isCorrect) | Choice | Создает новый вариант выбора. |
create Response(responses) | Item Response | Создает новый Item Response для этого флажка. |
duplicate() | Checkbox Item | Создает копию этого элемента и добавляет ее в конец формы. |
get Choices() | Choice[] | Получает все варианты выбора товара. |
get Feedback For Correct() | Quiz Feedback |null | Возвращает обратную связь, которая отображается респондентам, когда они правильно отвечают на вопрос. |
get Feedback For Incorrect() | Quiz Feedback |null | Возвращает обратную связь, которая отображается респондентам, когда они дают неверный ответ на вопрос. |
get Help Text() | String | Получает справочный текст элемента (иногда называемый описательным текстом для элементов макета, таких как Image Items , Page Break Items и Section Header Items ). |
get Id() | Integer | Получает уникальный идентификатор элемента. |
get Index() | Integer | Получает индекс элемента среди всех элементов в форме. |
get Points() | Integer | Возвращает балльное значение оцениваемого элемента. |
get Title() | String | Получает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ). |
get Type() | Item Type | Получает тип элемента, представленный в виде Item Type . |
has Other Option() | Boolean | Определяет, есть ли у товара вариант "другое". |
is Required() | Boolean | Определяет, обязан ли респондент ответить на вопрос. |
set Choice Values(values) | Checkbox Item | Задает варианты выбора элемента из массива строк. |
set Choices(choices) | Checkbox Item | Задает массив вариантов выбора для элемента. |
set Feedback For Correct(feedback) | Checkbox Item | Задает параметры обратной связи, отображаемые респондентам при правильном ответе на вопрос. |
set Feedback For Incorrect(feedback) | Checkbox Item | Задает параметры обратной связи, отображаемые респондентам в случае неправильного ответа на вопрос. |
set Help Text(text) | Checkbox Item | Задает текст справки для элемента (иногда называемый текстом описания для элементов макета, таких как Image Items , Page Break Items и Section Header Items ). |
set Points(points) | Checkbox Item | Устанавливает количество баллов, которое может быть присуждено оцениваемому элементу. |
set Required(enabled) | Checkbox Item | Определяет, обязан ли респондент ответить на вопрос. |
set Title(title) | Checkbox Item | Задает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ). |
set Validation(validation) | Checkbox Item | Устанавливает проверку данных для этого флажка. |
show Other Option(enabled) | Checkbox Item | Указывает, есть ли у товара опция "другое". |
Подробная документация
clear Validation()
Удаляет проверку данных для этого флажка.
Возвращаться
Checkbox Item — этот Checkbox Item для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
create Choice(value)
Создает новый вариант выбора.
Параметры
| Имя | Тип | Описание |
|---|---|---|
value | String | Значение выбора, которое респонденты видят в форме в виде метки. |
Возвращаться
Choice — новый выбор
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
create Choice(value, isCorrect)
Создает новый вариант выбора.
Параметры
| Имя | Тип | Описание |
|---|---|---|
value | String | Значение выбора, которое респонденты видят в форме в виде метки. |
is Correct | Boolean | является ли этот выбор правильным ответом |
Возвращаться
Choice — новый выбор
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
create Response(responses)
Создает новый Item Response для этого флажка. Аргумент responses представляет собой массив String[] , содержащий значения, которые необходимо отметить. Генерирует исключение, если какое-либо значение не соответствует допустимому выбору для этого элемента, если только show Other Option(enabled) не установлен в true .
Параметры
| Имя | Тип | Описание |
|---|---|---|
responses | String[] | множество допустимых ответов на этот вопрос с несколькими вариантами ответа |
Возвращаться
Item Response — ответ на задание
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
duplicate()
Создает копию этого элемента и добавляет ее в конец формы.
Возвращаться
Checkbox Item — дубликат этого Checkbox Item для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Choices()
Получает все варианты выбора товара.
Возвращаться
Choice[] — множество вариантов выбора
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Feedback For Correct()
Возвращает обратную связь, которая отображается респондентам, когда они правильно отвечают на вопрос.
Возвращаться
Quiz Feedback |null — отзыв, если таковой имеется.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Feedback For Incorrect()
Возвращает обратную связь, которая отображается респондентам, когда они дают неверный ответ на вопрос.
Возвращаться
Quiz Feedback |null — отзыв, если таковой имеется.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
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 Points()
Возвращает балльное значение оцениваемого элемента.
Возвращаться
Integer — количество баллов, которое стоит вопрос.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
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
has Other Option()
Определяет, есть ли у товара вариант "другое".
Возвращаться
Boolean — true если у элемента есть вариант "другое"; false если нет.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
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 Choice Values(values)
Задает варианты выбора элемента из массива строк. Генерирует исключение, если заданный массив пуст.
// Open a form by ID and add a new list item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
Параметры
| Имя | Тип | Описание |
|---|---|---|
values | String[] | Набор значений для выбора, которые респонденты видят в виде меток при просмотре формы. |
Возвращаться
Checkbox Item — этот Checkbox Item для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Choices(choices)
Задает массив вариантов выбора для элемента. Генерирует исключение, если заданный массив пуст или содержит null элемент.
// Open a form by ID and add a new list item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);
Параметры
| Имя | Тип | Описание |
|---|---|---|
choices | Choice[] | множество вариантов выбора |
Возвращаться
Checkbox Item — этот Checkbox Item для создания цепочек.
Броски
Error — если заданный массив равен null , пуст или содержит null элемент.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Feedback For Correct(feedback)
Задает параметры обратной связи, отображаемые респондентам при правильном ответе на вопрос.
// Open a form by ID and add a new list item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false), ]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText('Dogs rule, cats drool.').build(), );
Параметры
| Имя | Тип | Описание |
|---|---|---|
feedback | Quiz Feedback | Новая функция обратной связи. Значение null очистит обратную связь. |
Возвращаться
Checkbox Item — этот Checkbox Item для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Feedback For Incorrect(feedback)
Задает параметры обратной связи, отображаемые респондентам в случае неправильного ответа на вопрос.
Параметры
| Имя | Тип | Описание |
|---|---|---|
feedback | Quiz Feedback | новая обратная связь |
Возвращаться
Checkbox Item — этот Checkbox Item для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
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 Item — этот Checkbox Item для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Points(points)
Задает количество баллов, которое может быть присуждено оцениваемому предмету. Значение по умолчанию для новых предметов — 0.
Параметры
| Имя | Тип | Описание |
|---|---|---|
points | Integer | количество баллов, которое стоит вопрос |
Возвращаться
Checkbox Item — этот Checkbox Item для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Required(enabled)
Определяет, обязан ли респондент ответить на вопрос.
Параметры
| Имя | Тип | Описание |
|---|---|---|
enabled | Boolean | должен ли респондент ответить на этот вопрос? |
Возвращаться
Checkbox Item — текущий элемент (для создания цепочки)
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Title(title)
Задает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ).
Параметры
| Имя | Тип | Описание |
|---|---|---|
title | String | новый заголовок или подзаголовочный текст |
Возвращаться
Checkbox Item — этот Checkbox Item для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Validation(validation)
Задает проверку данных для этого флажка. Передача значения null или проверки без вызова каких-либо функций require приведет к удалению любой предыдущей проверки.
Параметры
| Имя | Тип | Описание |
|---|---|---|
validation | Checkbox Validation | Проверка состояния (CheckboxValidation), применяемая к этому элементу. |
Возвращаться
Checkbox Item — этот Checkbox Item для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
show Other Option(enabled)
Определяет, есть ли у элемента вариант "другое". По умолчанию для нового Checkbox Item или Multiple Choice Item равно false .
Параметры
| Имя | Тип | Описание |
|---|---|---|
enabled | Boolean | true если у товара есть вариант "другое"; false если нет. |
Возвращаться
Checkbox Item — этот Checkbox Item для создания цепочек.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms