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