Method: publishers.items.fetchReviews

Получение отзывов пользователей о товаре.

HTTP-запрос

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:fetchReviews

URL имеет синтаксис gRPC Transcoding.

Параметры пути

Параметры
name

string

Обязательно. Название ресурса, отзывы о котором запрашиваются. Формат: publishers/{publisher_id}/items/{itemId}

Параметры запроса

Параметры
pageSize

integer

Необязательное поле. Максимальное количество отзывов, которые нужно вернуть. Сервис может вернуть меньше результатов, чем указано в этом значении. Если значение не указано, будет возвращено не более 50 отзывов. Максимальное значение – 200. Значения выше 200 будут принудительно заменены на 200.
pageToken

string

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

При разбиении на страницы все остальные параметры, передаваемые в items.fetchReviews, должны соответствовать вызову, который предоставил токен страницы.
filter

string

Необязательное поле. Фильтр, который нужно применить к отзывам. Поддерживается только сравнение на равенство, например rating = 5.
orderBy

string

Необязательное поле. Необязательный список полей, разделенных запятыми, по которым нужно отсортировать результаты. По умолчанию используется сортировка по возрастанию (asc). Поддерживаемые поля: - rating: поддерживаемые порядки сортировки – asc (по умолчанию) и desc. - createTime: поддерживается только desc (сначала самые новые). Значение desc нужно указать явно, поскольку по умолчанию используется asc. Примеры: rating desc, createTime desc или rating desc, createTime desc.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ на запрос items.fetchReviews.

Ниже приведена структура данных в ответе, полученном на запрос.

JSON-представление 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "nextPageToken": string
}
Поля
reviews[]

object (Review)

Список отзывов.
nextPageToken

string

Токен, который можно отправить как pageToken, чтобы получить следующую страницу. Если это поле отсутствует, значит последующих страниц нет.

Области авторизации

Требует одной из следующих областей применения OAuth:

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

Проверить

Отзыв, написанный пользователем для оценки продукта в интернет-магазине Chrome.

JSON-представление 
{
  "name": string,
  "item": string,
  "authorInfo": {
    object (AuthorInfo)
  },
  "rating": integer,
  "comment": string,
  "createTime": string
}
Поля
name

string

Идентификатор. Название ресурса для отзыва. Формат: reviews/{reviewId}
item

string

Только для вывода. Объект, к которому относится отзыв. Формат: publishers/{publisher}/items/{item}
authorInfo

object (AuthorInfo)

Информация об авторе отзыва.
rating

integer

Оценка товара от 1 до 5.
comment

string

Содержание отзыва.
createTime

string (Timestamp format)

Только для вывода. Дата публикации отзыва.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".

AuthorInfo

Информация об авторе отзыва.

JSON-представление 
{
  "displayName": string
}
Поля
displayName

string

Отображаемое имя автора.