Class ScaleItem

ScaleItem

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

// Open a form by ID and add a new scale item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10')
    .setBounds(1, 10);

Методы

Метод Тип возврата Краткое описание
createResponse(response) ItemResponse Создает новый ItemResponse для этого элемента шкалы.
duplicate() ScaleItem Создает копию этого элемента и добавляет ее в конец формы.
getGeneralFeedback() QuizFeedback Возвращает отзыв, который отображается респондентам, когда они отвечают на оцениваемый вопрос.
getHelpText() String Получает текст справки по элементу (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems SectionHeaderItems ).
getId() Integer Получает уникальный идентификатор элемента.
getIndex() Integer Получает индекс элемента среди всех элементов формы.
getLeftLabel() String Получает метку нижней границы шкалы, если таковая имеется.
getLowerBound() Integer Получает нижнюю границу шкалы.
getPoints() Integer Возвращает количество баллов оцениваемого элемента.
getRightLabel() String Получает метку верхней границы шкалы, если таковая имеется.
getTitle() String Получает заголовок элемента (иногда называемый текстом заголовка, в случае с SectionHeaderItem ).
getType() ItemType Получает тип элемента, представленный как ItemType .
getUpperBound() Integer Получает верхнюю границу шкалы.
isRequired() Boolean Определяет, должен ли респондент отвечать на вопрос.
setBounds(lower, upper) ScaleItem Устанавливает нижнюю и верхнюю границы шкалы.
setGeneralFeedback(feedback) ScaleItem Устанавливает обратную связь, которая будет отображаться респондентам, когда они отвечают на оцениваемый вопрос, на который нет правильного или неправильного ответа (т. е. вопросы, требующие оценки вручную).
setHelpText(text) ScaleItem Устанавливает текст справки для элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems SectionHeaderItems ).
setLabels(lower, upper) ScaleItem Устанавливает метки для нижней и верхней границ шкалы.
setPoints(points) ScaleItem Устанавливает количество баллов, которое дает оцениваемый предмет.
setRequired(enabled) ScaleItem Устанавливает, должен ли респондент отвечать на вопрос.
setTitle(title) ScaleItem Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).

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

createResponse(response)

Создает новый ItemResponse для этого элемента шкалы. Вызывает исключение, если аргумент response выходит за пределы, установленные для элемента.

Параметры

Имя Тип Описание
response Integer ответ значения для этого элемента шкалы

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

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

Авторизация

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

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

duplicate()

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

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

ScaleItem — дубликат ScaleItem для цепочки

Авторизация

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

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

getGeneralFeedback()

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

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

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

getLeftLabel()

Получает метку нижней границы шкалы, если таковая имеется.

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

String — метка нижней границы шкалы.

Авторизация

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

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

getLowerBound()

Получает нижнюю границу шкалы.

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

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

getRightLabel()

Получает метку верхней границы шкалы, если таковая имеется.

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

String — метка верхней границы шкалы.

Авторизация

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

  • 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

getUpperBound()

Получает верхнюю границу шкалы.

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

Integer — верхняя граница шкалы.

Авторизация

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

  • 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

setBounds(lower, upper)

Устанавливает нижнюю и верхнюю границы шкалы. Нижняя граница должна быть 0 или 1 . Верхняя граница должна находиться в диапазоне от 3 до 10 включительно. По умолчанию новая шкала имеет нижнюю границу 1 и верхнюю границу 5 .

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

Параметры

Имя Тип Описание
lower Integer новая нижняя граница
upper Integer новая верхняя граница

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

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

Броски

Error — если нижняя или верхняя граница недействительна.

Авторизация

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

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

setGeneralFeedback(feedback)

Устанавливает обратную связь, которая будет отображаться респондентам, когда они отвечают на оцениваемый вопрос, на который нет правильного или неправильного ответа (т. е. вопросы, требующие оценки вручную).

Параметры

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

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

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

Авторизация

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

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

setHelpText(text)

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

Параметры

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

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

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

Авторизация

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

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

setLabels(lower, upper)

Устанавливает метки для нижней и верхней границ шкалы.

Параметры

Имя Тип Описание
lower String новая метка для нижней границы
upper String новая метка для верхней границы

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

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

Авторизация

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

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

setPoints(points)

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

Параметры

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

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

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

Авторизация

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

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

setRequired(enabled)

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

Параметры

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

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

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

Авторизация

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

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

setTitle(title)

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

Параметры

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

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

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

Авторизация

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

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