Class MultipleChoiceItem

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

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

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

Методы

Метод Тип возврата Краткое описание
createChoice(value) Choice Создает новый выбор.
createChoice(value, isCorrect) Choice Создает новый выбор.
createChoice(value, navigationItem) Choice Создает новый выбор с параметром навигации по страницам, который переходит к заданному элементу разрыва страницы.
createChoice(value, navigationType) Choice Создает новый выбор с возможностью навигации по страницам.
createResponse(response) ItemResponse Создает новый ItemResponse для этого элемента множественного выбора.
duplicate() MultipleChoiceItem Создает копию этого элемента и добавляет ее в конец формы.
getChoices() Choice[] Получает все варианты выбора для элемента.
getFeedbackForCorrect() QuizFeedback Возвращает отзыв, который показывается респондентам, когда они правильно отвечают на вопрос.
getFeedbackForIncorrect() QuizFeedback Возвращает обратную связь, которая показывается респондентам, когда они неправильно отвечают на вопрос.
getHelpText() String Получает текст справки элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems и SectionHeaderItems ).
getId() Integer Получает уникальный идентификатор элемента.
getIndex() Integer Получает индекс элемента среди всех элементов в форме.
getPoints() Integer Возвращает количество баллов оцениваемого предмета.
getTitle() String Получает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).
getType() ItemType Получает тип элемента, представленный как ItemType .
hasOtherOption() Boolean Определяет, есть ли у элемента опция «другое».
isRequired() Boolean Определяет, должен ли респондент отвечать на вопрос.
setChoiceValues(values) MultipleChoiceItem Задает варианты выбора элемента из массива строк.
setChoices(choices) MultipleChoiceItem Устанавливает массив вариантов выбора для элемента.
setFeedbackForCorrect(feedback) MultipleChoiceItem Устанавливает, что респондентам будет показана обратная связь, когда они правильно ответят на вопрос.
setFeedbackForIncorrect(feedback) MultipleChoiceItem Устанавливает обратную связь, которая будет отображаться для респондентов, когда они неправильно отвечают на вопрос.
setHelpText(text) MultipleChoiceItem Задает текст справки элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems и SectionHeaderItems ).
setPoints(points) MultipleChoiceItem Устанавливает количество баллов, которое оценивается оцениваемым элементом.
setRequired(enabled) MultipleChoiceItem Устанавливает, должен ли респондент отвечать на вопрос.
setTitle(title) MultipleChoiceItem Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).
showOtherOption(enabled) MultipleChoiceItem Устанавливает, имеет ли элемент «другое» значение.

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

createChoice(value)

Создает новый выбор.

Параметры

Имя Тип Описание
value String значение выбора, которое респонденты видят как метку при просмотре формы

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

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

Авторизация

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

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

createChoice(value, isCorrect)

Создает новый выбор.

Параметры

Имя Тип Описание
value String значение выбора, которое респонденты видят как метку при просмотре формы
isCorrect Boolean является ли выбор правильным ответом

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

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

Авторизация

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

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

createChoice(value, navigationItem)

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

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

Параметры

Имя Тип Описание
value String значение выбора, которое респонденты видят как метку при просмотре формы
navigationItem PageBreakItem элемент для перехода к

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

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

Авторизация

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

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

createChoice(value, navigationType)

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

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

Параметры

Имя Тип Описание
value String значение выбора, которое респонденты видят как метку при просмотре формы
navigationType PageNavigationType выбор типа навигации

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

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

Авторизация

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

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

createResponse(response)

Создает новый ItemResponse для этого элемента множественного выбора. Выдает исключение, если аргумент response не соответствует допустимому выбору для этого элемента, если для showOtherOption(enabled) не задано значение true .

Параметры

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

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

ItemResponse — ответ элемента

Авторизация

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

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

duplicate()

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

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

MultipleChoiceItem — дубликат этого MultipleChoiceItem для цепочки

Авторизация

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

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

getChoices()

Получает все варианты выбора для элемента.

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

Choice[] — массив вариантов

Авторизация

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

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

getFeedbackForCorrect()

Возвращает отзыв, который показывается респондентам, когда они правильно отвечают на вопрос.

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

QuizFeedback — отзыв, если он есть.

Авторизация

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

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

getFeedbackForIncorrect()

Возвращает обратную связь, которая показывается респондентам, когда они неправильно отвечают на вопрос.

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

QuizFeedback — отзыв, если он есть.

Авторизация

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

  • 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

getPoints()

Возвращает количество баллов оцениваемого предмета.

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

Integer число — количество баллов за вопрос.

Авторизация

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

  • 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

hasOtherOption()

Определяет, есть ли у элемента опция «другое».

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

Booleantrue , если у элемента есть опция «другое»; false , если нет

Авторизация

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

  • 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

setChoiceValues(values)

Задает варианты выбора элемента из массива строк. Выдает исключение, если данный массив пуст.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Параметры

Имя Тип Описание
values String[] массив значений выбора, которые респонденты видят как метки при просмотре формы

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

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

Авторизация

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

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

setChoices(choices)

Устанавливает массив вариантов выбора для элемента. Выдает исключение, если данный массив пуст или содержит null элемент.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

Параметры

Имя Тип Описание
choices Choice[] множество вариантов

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

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

Броски

Error — если заданный массив null , пустой или содержит null элемент

Авторизация

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

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

setFeedbackForCorrect(feedback)

Устанавливает, что респондентам будет показана обратная связь, когда они правильно ответят на вопрос.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 QuizFeedback новый отзыв. Нулевое значение очистит обратную связь.

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

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

Авторизация

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

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

setFeedbackForIncorrect(feedback)

Устанавливает обратную связь, которая будет отображаться для респондентов, когда они неправильно отвечают на вопрос.

Параметры

Имя Тип Описание
feedback QuizFeedback новый отзыв

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

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

Авторизация

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

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

setHelpText(text)

Задает текст справки элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems и SectionHeaderItems ).

Параметры

Имя Тип Описание
text String новый текст справки

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

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

Авторизация

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

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

setPoints(points)

Устанавливает количество баллов, которое оценивается оцениваемым элементом. По умолчанию для новых элементов установлено значение 0.

Параметры

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

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

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

Авторизация

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

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

setRequired(enabled)

Устанавливает, должен ли респондент отвечать на вопрос.

Параметры

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

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

MultipleChoiceItem — текущий элемент (для цепочки)

Авторизация

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

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

setTitle(title)

Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).

Параметры

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

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

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

Авторизация

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

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

showOtherOption(enabled)

Устанавливает, имеет ли элемент «другое» значение. По умолчанию для нового CheckboxItem или MultipleChoiceItem установлено значение false .

Параметры

Имя Тип Описание
enabled Boolean true , если у элемента есть опция «другое»; false , если нет

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

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

Авторизация

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

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