Эта страница переведена с помощью 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);

Методы

Метод	Тип возврата	Краткое описание
`createResponse(response)`	`ItemResponse`	Создает новый `ItemResponse` для этого элемента рейтинга.
`duplicate()`	`RatingItem`	Создает копию этого элемента и добавляет ее в конец формы.
`getGeneralFeedback()`	`QuizFeedback`	Возвращает отзыв, который отображается респондентам, когда они отвечают на оцениваемый вопрос.
`getHelpText()`	`String`	Получает текст справки по элементу (иногда называемый текстом описания для таких элементов макета, как `ImageItems` , `PageBreakItems` `SectionHeaderItems` ).
`getId()`	`Integer`	Получает уникальный идентификатор элемента.
`getIndex()`	`Integer`	Получает индекс элемента среди всех элементов формы.
`getPoints()`	`Integer`	Возвращает количество баллов оцениваемого элемента.
`getRatingIcon()`	`RatingIconType`	Получает значок, выбранный для рейтинга.
`getRatingScaleLevel()`	`Integer`	Получает уровень шкалы рейтинга.
`getTitle()`	`String`	Получает заголовок элемента (иногда называемый текстом заголовка, в случае с `SectionHeaderItem` ).
`getType()`	`ItemType`	Получает тип элемента, представленный как `ItemType` .
`isRequired()`	`Boolean`	Определяет, должен ли респондент отвечать на вопрос.
`setGeneralFeedback(feedback)`	`RatingItem`	Устанавливает обратную связь, отображаемую респондентам, когда они отвечают на оцениваемый вопрос, на который нет правильного или неправильного ответа (т. е. вопросы, требующие оценки вручную).
`setHelpText(text)`	`RatingItem`	Устанавливает текст справки для элемента (иногда называемый текстом описания для таких элементов макета, как `ImageItems` , `PageBreakItems` `SectionHeaderItems` ).
`setPoints(points)`	`RatingItem`	Устанавливает количество баллов, которое дает оцениваемый предмет.
`setRatingIcon(ratingIcon)`	`RatingItem`	Устанавливает значок рейтинга.
`setRatingScaleLevel(ratingScaleLevel)`	`RatingItem`	Устанавливает уровень шкалы рейтинга.
`setRequired(enabled)`	`RatingItem`	Устанавливает, должен ли респондент отвечать на вопрос.
`setTitle(title)`	`RatingItem`	Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае `SectionHeaderItem` ).

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

`createResponse(response)`

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

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

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

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

Параметры

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

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

ItemResponse — Ответ элемента.

Авторизация

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

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

`duplicate()`

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

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

RatingItem — дубликат этого RatingItem для цепочки

Авторизация

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

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

`getPoints()`

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

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

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

Авторизация

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

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

`getRatingIcon()`

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

// 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();

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

RatingIconType — Тип значка рейтинга.

Авторизация

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

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

`getRatingScaleLevel()`

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

// 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

`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

`isRequired()`

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

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

Boolean — должен ли респондент отвечать на вопрос

Авторизация

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

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

`setGeneralFeedback(feedback)`

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

Параметры

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

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

RatingItem — этот RatingItem для цепочки

Авторизация

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

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

`setHelpText(text)`

Устанавливает текст справки для элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems SectionHeaderItems ).

Параметры

Имя	Тип	Описание
`text`	`String`	новый текст справки

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

RatingItem — этот RatingItem для цепочки

Авторизация

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

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

`setPoints(points)`

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

Параметры

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

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

RatingItem — этот RatingItem для цепочки

Авторизация

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

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

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

Параметры

Имя	Тип	Описание
`ratingIcon`	`RatingIconType`	Тип значка рейтинга.

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

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

Броски

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

Авторизация

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

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

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

Параметры

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

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

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

Броски

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

Авторизация

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

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

`setRequired(enabled)`

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

Параметры

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

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

RatingItem — текущий элемент (для цепочки)

Авторизация

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

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

`setTitle(title)`

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

Параметры

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

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

RatingItem — этот RatingItem для цепочки

Авторизация

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

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