Элемент вопроса, который позволяет респонденту выбрать один вариант из пронумерованной последовательности переключателей. К элементам можно получить доступ или создать их из 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()
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