Class ScaleItem

Масштабируемый элемент

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

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

Методы

Метод Тип возврата Краткое описание
create Response(response) Item Response Создает новый Item Response для этого элемента шкалы.
duplicate() Scale Item Создает копию этого элемента и добавляет ее в конец формы.
get General Feedback() Quiz Feedback Возвращает отзыв, который отображается респондентам, когда они отвечают на оцениваемый вопрос.
get Help Text() String Получает текст справки по элементу (иногда называемый текстом описания для таких элементов макета, как Image Items , Page Break Items и Section Header Items ).
get Id() Integer Получает уникальный идентификатор элемента.
get Index() Integer Получает индекс элемента среди всех элементов формы.
get Left Label() String Получает метку нижней границы шкалы, если таковая имеется.
get Lower Bound() Integer Получает нижнюю границу шкалы.
get Points() Integer Возвращает количество баллов оцениваемого элемента.
get Right Label() String Получает метку верхней границы шкалы, если таковая имеется.
get Title() String Получает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ).
get Type() Item Type Получает тип элемента, представленный как Item Type .
get Upper Bound() Integer Получает верхнюю границу шкалы.
is Required() Boolean Определяет, должен ли респондент отвечать на вопрос.
set Bounds(lower, upper) Scale Item Устанавливает нижнюю и верхнюю границы шкалы.
set General Feedback(feedback) Scale Item Устанавливает обратную связь, отображаемую респондентам, когда они отвечают на оцениваемый вопрос, на который нет правильного или неправильного ответа (т. е. вопросы, требующие оценки вручную).
set Help Text(text) Scale Item Устанавливает текст справки для элемента (иногда называемый текстом описания для таких элементов макета, как Image Items , Page Break Items » и Section Header Items ).
set Labels(lower, upper) Scale Item Устанавливает метки для нижней и верхней границ шкалы.
set Points(points) Scale Item Устанавливает количество баллов, которое дает оцениваемый предмет.
set Required(enabled) Scale Item Устанавливает, должен ли респондент отвечать на вопрос.
set Title(title) Scale Item Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ).

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

create Response(response)

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

Параметры

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

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

Item Response — ответ элемента

Авторизация

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

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

duplicate()

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

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

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

Авторизация

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

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

get General Feedback()

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

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

Quiz Feedback — обратная связь, если она есть.

Авторизация

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

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

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

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

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

Авторизация

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

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

get Lower Bound()

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

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

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 Right Label()

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

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

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

Авторизация

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

  • 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

get Upper Bound()

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

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

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

Авторизация

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

  • 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 Bounds(lower, upper)

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

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

Параметры

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

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

Scale Item — этот Scale Item , для цепочки

Броски

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

Авторизация

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

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

set General Feedback(feedback)

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

Параметры

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

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

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

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

Scale Item — этот Scale Item , для цепочки

Авторизация

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

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

set Labels(lower, upper)

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

Параметры

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

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

Scale Item — этот Scale Item , для цепочки

Авторизация

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

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

set Points(points)

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

Параметры

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

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

Scale Item — этот Scale Item , для цепочки

Авторизация

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

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

set Required(enabled)

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

Параметры

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

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

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

Авторизация

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

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

set Title(title)

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

Параметры

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

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

Scale Item — этот Scale Item , для цепочки

Авторизация

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

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