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