Class MultipleChoiceItem

Вариант ответа

Вопрос, позволяющий респонденту выбрать один вариант из списка переключателей или необязательного поля «другое». Доступ к вопросам можно получить или создать через Form . При использовании в викторине эти вопросы оцениваются автоматически.

// Open a form by ID and add a new multiple choice item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([item.createChoice('Cats'), item.createChoice('Dogs')])
    .showOtherOption(true);

Методы

Метод Тип возвращаемого значения Краткое описание
create Choice(value) Choice Создает новый вариант выбора.
create Choice(value, isCorrect) Choice Создает новый вариант выбора.
create Choice(value, navigationItem) Choice Создает новый вариант выбора с опцией навигации по страницам, которая позволяет перейти к указанному элементу разрыва страницы.
create Choice(value, navigationType) Choice Создает новый вариант выбора с опцией навигации по страницам.
create Response(response) Item Response Создает новый Item Response на этот вопрос с несколькими вариантами ответа.
duplicate() Multiple Choice 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) Multiple Choice Item Задает варианты выбора элемента из массива строк.
set Choices(choices) Multiple Choice Item Задает массив вариантов выбора для элемента.
set Feedback For Correct(feedback) Multiple Choice Item Задает параметры обратной связи, отображаемые респондентам при правильном ответе на вопрос.
set Feedback For Incorrect(feedback) Multiple Choice Item Задает параметры обратной связи, отображаемые респондентам в случае неправильного ответа на вопрос.
set Help Text(text) Multiple Choice Item Задает текст справки для элемента (иногда называемый текстом описания для элементов макета, таких как Image Items , Page Break Items и Section Header Items ).
set Points(points) Multiple Choice Item Устанавливает количество баллов, которое может быть присуждено оцениваемому элементу.
set Required(enabled) Multiple Choice Item Определяет, обязан ли респондент ответить на вопрос.
set Title(title) Multiple Choice Item Задает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ).
show Other Option(enabled) Multiple Choice Item Указывает, есть ли у товара опция "другое".

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

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 Choice(value, navigationItem)

Создает новый вариант выбора с опцией навигации по страницам, которая переходит к заданному элементу разрыва страницы. Это эквивалентно create Choice(value, navigationType) с navigation Type , установленным на Form App.PageNavigationType.GO_TO_PAGE . Варианты выбора, использующие навигацию по страницам, нельзя объединять в одном элементе с вариантами выбора, не использующими навигацию по страницам.

Навигация по страницам происходит после того, как респондент завершит заполнение страницы, содержащей выбранный вариант, и только если респондент выбрал именно этот вариант. Если респондент выбрал несколько вариантов с инструкциями по навигации по страницам на одной странице, то эффект будет иметь только последний выбранный вариант. Навигация по страницам также не влияет на последнюю страницу формы.

Обратите внимание, что использование навигации по страницам для элемента жестко задает маршрутизацию, а это значит, что showOtherOption(true) не следует использовать одновременно.

Параметры

Имя Тип Описание
value String Значение выбора, которое респонденты видят в форме в виде метки.
navigation Item Page Break Item элемент, к которому нужно перейти

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

Choice — новый выбор

Авторизация

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

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

create Choice(value, navigationType)

Создает новый вариант выбора с возможностью постраничной навигации. Варианты выбора, использующие постраничную навигацию, нельзя объединять в одном элементе с вариантами выбора, не использующими постраничную навигацию.

Навигация по страницам происходит после того, как респондент завершит заполнение страницы, содержащей выбранный вариант, и только если респондент выбрал именно этот вариант. Если респондент выбрал несколько вариантов с инструкциями по навигации по страницам на одной странице, то эффект будет иметь только последний выбранный вариант. Навигация по страницам также не влияет на последнюю страницу формы.

Обратите внимание, что использование навигации по страницам для элемента жестко задает маршрутизацию, а это значит, что showOtherOption(true) не следует использовать одновременно.

Параметры

Имя Тип Описание
value String Значение выбора, которое респонденты видят в форме в виде метки.
navigation Type Page Navigation Type тип навигации в зависимости от выбранного варианта

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

Choice — новый выбор

Авторизация

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

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

create Response(response)

Создает новый Item Response для этого варианта ответа с несколькими вариантами выбора. Генерирует исключение, если аргумент response не соответствует допустимому варианту выбора для этого варианта, если только show Other Option(enabled) не установлен в true .

Параметры

Имя Тип Описание
response String правильный ответ на этот вопрос с несколькими вариантами ответа

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

Item Response — ответ на задание

Авторизация

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

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

duplicate()

Создает копию этого элемента и добавляет ее в конец формы.

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

Multiple Choice Item — дубликат этого Multiple Choice 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[] Набор значений для выбора, которые респонденты видят в виде меток при просмотре формы.

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

Multiple Choice Item — этот Multiple Choice 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[] множество вариантов выбора

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

Multiple Choice Item — этот Multiple Choice 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().setText('Dogs rule, cats drool.').build(),
);

Параметры

Имя Тип Описание
feedback Quiz Feedback Новая функция обратной связи. Значение null очистит обратную связь.

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

Multiple Choice Item — этот Multiple Choice Item для создания цепочки

Авторизация

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

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

set Feedback For Incorrect(feedback)

Задает параметры обратной связи, отображаемые респондентам в случае неправильного ответа на вопрос.

Параметры

Имя Тип Описание
feedback Quiz Feedback новая обратная связь

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

Multiple Choice Item — этот Multiple Choice 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 новый текст справки

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

Multiple Choice Item — этот Multiple Choice Item для создания цепочки

Авторизация

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

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

set Points(points)

Задает количество баллов, которое может быть присуждено оцениваемому предмету. Значение по умолчанию для новых предметов — 0.

Параметры

Имя Тип Описание
points Integer количество баллов, которое стоит вопрос

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

Multiple Choice Item — этот Multiple Choice Item для создания цепочки

Авторизация

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

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

set Required(enabled)

Определяет, обязан ли респондент ответить на вопрос.

Параметры

Имя Тип Описание
enabled Boolean должен ли респондент ответить на этот вопрос?

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

Multiple Choice Item — текущий элемент (для построения цепочки)

Авторизация

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

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

set Title(title)

Задает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ).

Параметры

Имя Тип Описание
title String новый заголовок или подзаголовочный текст

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

Multiple Choice Item — этот Multiple Choice 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 если нет.

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

Multiple Choice Item — этот Multiple Choice Item для создания цепочки

Авторизация

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

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