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

Class RatingItem

Элемент вопроса, позволяющий респонденту поставить оценку. К элементам можно получить доступ или создать их из Form . При использовании в викторине эти элементы оцениваются.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and access its properties.
const existingRatingItem = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = existingRatingItem.getRatingScaleLevel();
const ratingIcon = existingRatingItem.getRatingIcon();

// Create a new rating item.
const ratingItem = form.addRatingItem();

// Update the rating item's properties via chaining.
ratingItem.setRatingScaleLevel(7).setRatingIcon(FormApp.RatingIconType.HEART);

Методы

Метод	Тип возврата	Краткое описание
`create Response(response)`	`Item Response`	Создает новый `Item Response` для этого элемента рейтинга.
`duplicate()`	`Rating 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 Points()`	`Integer`	Возвращает количество баллов оцениваемого элемента.
`get Rating Icon()`	`Rating Icon Type`	Получает значок, выбранный для рейтинга.
`get Rating Scale Level()`	`Integer`	Получает уровень шкалы рейтинга.
`get Title()`	`String`	Получает заголовок элемента (иногда называемый текстом заголовка, в случае `Section Header Item` ).
`get Type()`	`Item Type`	Получает тип элемента, представленный как `Item Type` .
`is Required()`	`Boolean`	Определяет, должен ли респондент отвечать на вопрос.
`set General Feedback(feedback)`	`Rating Item`	Устанавливает обратную связь, отображаемую респондентам, когда они отвечают на оцениваемый вопрос, на который нет правильного или неправильного ответа (т. е. вопросы, требующие оценки вручную).
`set Help Text(text)`	`Rating Item`	Устанавливает текст справки для элемента (иногда называемый текстом описания для таких элементов макета, как `Image Items` , `Page Break Items` » и `Section Header Items` ).
`set Points(points)`	`Rating Item`	Устанавливает количество баллов, которое дает оцениваемый предмет.
`set Rating Icon(ratingIcon)`	`Rating Item`	Устанавливает значок рейтинга.
`set Rating Scale Level(ratingScaleLevel)`	`Rating Item`	Устанавливает максимальный уровень шкалы рейтинга.
`set Required(enabled)`	`Rating Item`	Устанавливает, должен ли респондент отвечать на вопрос.
`set Title(title)`	`Rating Item`	Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае `Section Header Item` ).

Подробная документация

`create Response(response)`

Создает новый Item Response для этого элемента рейтинга.

Выдает исключение сценария, если предоставленный response меньше 1 или больше значения, возвращаемого методом get Rating Scale Level() .

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and create a response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

Параметры

Имя	Тип	Описание
`response`	`Integer`	Ценный ответ для этого элемента рейтинга.

Возвращаться

Item Response — ответ элемента.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`duplicate()`

Создает копию этого элемента и добавляет ее в конец формы.

Возвращаться

Rating Item — дубликат этого Rating 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 Points()`

Возвращает количество баллов оцениваемого элемента.

Возвращаться

Integer — количество баллов, которое приносит вопрос.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`get Rating Icon()`

Получает значок, выбранный для рейтинга.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingIcon = item.getRatingIcon();

Возвращаться

Rating Icon Type — тип значка рейтинга.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`get Rating Scale Level()`

Получает уровень шкалы рейтинга.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = item.getRatingScaleLevel();

Возвращаться

Integer — уровень шкалы рейтинга.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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()`

Получает тип элемента, представленный как Item Type .

Возвращаться

Item Type — тип предмета.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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 General Feedback(feedback)`

Устанавливает обратную связь, которая будет отображаться респондентам, когда они отвечают на оцениваемый вопрос, на который нет правильного или неправильного ответа (т. е. вопросы, требующие оценки вручную).

Параметры

Имя	Тип	Описание
`feedback`	`Quiz Feedback`	новый отзыв

Возвращаться

Rating Item — этот Rating 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`	новый текст справки

Возвращаться

Rating Item — этот Rating Item , для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`set Points(points)`

Устанавливает количество баллов, которое дает оцениваемый предмет. По умолчанию для новых элементов установлено значение 0.

Параметры

Имя	Тип	Описание
`points`	`Integer`	количество баллов, которое приносит вопрос

Возвращаться

Rating Item — этот Rating Item , для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`set Rating Icon(ratingIcon)`

Устанавливает значок рейтинга.

Выдает исключение сценария, если тип значка рейтинга недействителен.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingIcon(FormApp.RatingIconType.THUMB_UP);

Параметры

Имя	Тип	Описание
`rating Icon`	`Rating Icon Type`	Тип значка рейтинга.

Возвращаться

Rating Item — этот Rating Item для цепочки.

Броски

Error — если тип значка рейтинга недействителен.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`set Rating Scale Level(ratingScaleLevel)`

Устанавливает максимальный уровень шкалы рейтинга. Максимальный уровень шкалы рейтинга должен находиться в диапазоне от 3 до 10 включительно. Новый рейтинг по умолчанию соответствует уровню рейтинговой шкалы 3 .

Выдает исключение сценария, если заданные значения выходят за допустимые пределы.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingScaleLevel(7);

Параметры

Имя	Тип	Описание
`rating Scale Level`	`Integer`	Уровень шкалы рейтинга.

Возвращаться

Rating Item — этот Rating Item для цепочки.

Броски

Error — если уровень рейтинговой шкалы недействителен.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`set Required(enabled)`

Устанавливает, должен ли респондент отвечать на вопрос.

Параметры

Имя	Тип	Описание
`enabled`	`Boolean`	должен ли респондент отвечать на вопрос

Возвращаться

Rating Item — текущий предмет (для цепочки)

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`set Title(title)`

Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае Section Header Item ).

Параметры

Имя	Тип	Описание
`title`	`String`	новый заголовок или текст заголовка

Возвращаться

Rating Item — этот Rating Item , для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms