Class ListItem

Пункт списка

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

// 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?')
    .setChoices([
        item.createChoice('Cats'),
        item.createChoice('Dogs')
    ]);

Методы

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

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

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 не соответствует допустимому выбору для этого элемента.

Параметры

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

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

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

Авторизация

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

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

duplicate()

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

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

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

Авторизация

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

  • 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

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[] массив значений выбора, которые респонденты видят как метки при просмотре формы

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

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

Авторизация

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

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

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

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

Броски

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

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

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

Авторизация

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

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

setFeedbackForIncorrect(feedback)

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

Параметры

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

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

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

Авторизация

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

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

setHelpText(text)

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

Параметры

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

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

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

Авторизация

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

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

setPoints(points)

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

Параметры

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

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

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

Авторизация

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

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

setRequired(enabled)

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

Параметры

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

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

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

Авторизация

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

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

setTitle(title)

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

Параметры

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

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

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

Авторизация

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

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