Class CheckboxItem

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

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

// Open a form by ID and add a new checkbox item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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);

Методы

Метод Тип возврата Краткое описание
clearValidation() CheckboxItem Удаляет любую проверку данных для этого флажка.
createChoice(value) Choice Создает новый выбор.
createChoice(value, isCorrect) Choice Создает новый выбор.
createResponse(responses) ItemResponse Создает новый ItemResponse для этого флажка.
duplicate() CheckboxItem Создает копию этого элемента и добавляет ее в конец формы.
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) CheckboxItem Задает варианты выбора элемента из массива строк.
setChoices(choices) CheckboxItem Устанавливает массив вариантов выбора для элемента.
setFeedbackForCorrect(feedback) CheckboxItem Устанавливает, что респондентам будет показана обратная связь, когда они правильно ответят на вопрос.
setFeedbackForIncorrect(feedback) CheckboxItem Устанавливает обратную связь, которая будет отображаться для респондентов, когда они неправильно отвечают на вопрос.
setHelpText(text) CheckboxItem Задает текст справки элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems и SectionHeaderItems ).
setPoints(points) CheckboxItem Устанавливает количество баллов, которое оценивается оцениваемым элементом.
setRequired(enabled) CheckboxItem Устанавливает, должен ли респондент отвечать на вопрос.
setTitle(title) CheckboxItem Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).
setValidation(validation) CheckboxItem Задает проверку данных для этого флажка.
showOtherOption(enabled) CheckboxItem Устанавливает, имеет ли элемент «другое» значение.

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

clearValidation()

Удаляет любую проверку данных для этого флажка.

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

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

Авторизация

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

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

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

createResponse(responses)

Создает новый ItemResponse для этого флажка. responses аргументов представляют собой массив String[] , содержащий значения, которые необходимо проверить. Выдает исключение, если какое-либо значение не соответствует допустимому выбору для этого элемента, если для showOtherOption(enabled) не задано значение true .

Параметры

Имя Тип Описание
responses String[] массив допустимых ответов для этого элемента множественного выбора

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

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

Авторизация

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

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

duplicate()

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

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

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

Авторизация

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

  • 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()

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

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

Boolean — true , если у элемента есть опция «другое»; 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[] массив значений выбора, которые респонденты видят как метки при просмотре формы

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

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

Авторизация

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

  • 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[] множество вариантов

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

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

Броски

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 новый отзыв. Нулевое значение очистит обратную связь.

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

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

Авторизация

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

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

setFeedbackForIncorrect(feedback)

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

Параметры

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

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

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

Авторизация

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

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

setHelpText(text)

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

Параметры

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

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

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

Авторизация

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

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

setPoints(points)

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

Параметры

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

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

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

Авторизация

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

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

setRequired(enabled)

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

Параметры

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

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

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

Авторизация

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

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

setTitle(title)

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

Параметры

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

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

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

Авторизация

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

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

setValidation(validation)

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

Параметры

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

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

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

Авторизация

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

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

showOtherOption(enabled)

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

Параметры

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

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

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

Авторизация

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

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