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 |null Возвращает обратную связь, которая отображается респондентам, когда они отвечают на вопрос, за который можно поставить оценку.
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 ).

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

createResponse(response)

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

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

// 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 Ответ, содержащий оценочное значимую величину, для данного пункта оценки.

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

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

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 Quiz Feedback новая обратная связь

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

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

Параметры

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

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

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

Параметры

Имя Тип Описание
rating Scale Level 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