Эта страница переведена с помощью Cloud Translation API.

Class ScaleItem

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

Получает тип элемента, представленный как 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`	`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