Вопрос, позволяющий респонденту выбрать один вариант из последовательности пронумерованных переключателей. Доступ к вопросам можно получить или создать через 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 |null | Возвращает обратную связь, которая отображается респондентам, когда они отвечают на вопрос, за который можно поставить оценку. |
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 ). |
Подробная документация
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 |null — отзыв, если таковой имеется.
Авторизация
Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :
-
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 | Quiz Feedback | новая обратная связь |
Возвращаться
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