REST Resource: reviews

Ресурс: Обзор

Обзор приложения для Android.

JSON-представление 
{
  "reviewId": string,
  "authorName": string,
  "comments": [
    {
      object (Comment)
    }
  ]
}
Поля
reviewId

string

Уникальный идентификатор этого отзыва.

authorName

string

Имя пользователя, написавшего отзыв.

comments[]

object ( Comment )

Повторяющееся поле, содержащее комментарии к обзору.

Комментарий

Запись беседы между пользователем и разработчиком.

JSON-представление 
{

  // Union field comment can be only one of the following:
  "userComment": {
    object (UserComment)
  },
  "developerComment": {
    object (DeveloperComment)
  }
  // End of list of possible types for union field comment.
}
Поля

comment к профсоюзному полю.

comment может быть только одним из следующих:

userComment

object ( UserComment )

Комментарий пользователя.

developerComment

object ( DeveloperComment )

Комментарий разработчика.

Комментарий пользователя

Запись пользователя из разговора между пользователем и разработчиком.

JSON-представление 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  },
  "starRating": integer,
  "reviewerLanguage": string,
  "device": string,
  "androidOsVersion": integer,
  "appVersionCode": integer,
  "appVersionName": string,
  "thumbsUpCount": integer,
  "thumbsDownCount": integer,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "originalText": string
}
Поля
text

string

Содержание комментария, т.е. текст отзыва. В некоторых случаях пользователи могли написать отзыв с раздельными заголовком и текстом; в таких случаях заголовок и текст объединяются и разделяются символом табуляции.

lastModified

object ( Timestamp )

Последний раз, когда этот комментарий обновлялся.

starRating

integer

Рейтинг отзыва по шкале от 1 до 5.

reviewerLanguage

string

Код языка рецензента. Берётся из настроек устройства, поэтому не гарантируется соответствие языку, на котором написан отзыв. Может отсутствовать.

device

string

Кодовое имя устройства рецензента, например, klte, flounder. Может отсутствовать.

androidOsVersion

integer

Целое число — версия Android SDK устройства пользователя на момент написания обзора, например, 23 — Marshmallow. Может отсутствовать.

appVersionCode

integer

Целочисленный код версии приложения, установленный на момент написания обзора. Может отсутствовать.

appVersionName

string

Строка с названием версии приложения, установленной на момент написания отзыва. Может отсутствовать.

thumbsUpCount

integer

Количество пользователей, которые оценили этот отзыв как положительный.

thumbsDownCount

integer

Количество пользователей, поставивших этому обзору оценку «не нравится».

deviceMetadata

object ( DeviceMetadata )

Информация о характеристиках устройства пользователя.

originalText

string

Непереведённый текст отзыва, если отзыв был переведён. Если отзыв не был переведён, это поле остаётся пустым.

Метка времени

Метка времени представляет собой момент времени, не зависящий от часового пояса или местного календаря, закодированный в виде количества секунд и долей секунд с наносекундным разрешением. Отсчёт производится относительно эпохи, наступившей в полночь по всемирному координированному времени (UTC) 1 января 1970 года.

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

string ( int64 format)

Представляет секунды времени UTC с эпохи Unix.

nanos

integer

Неотрицательные доли секунды с разрешением в наносекунды. Должны быть в диапазоне от 0 до 999 999 999 включительно.

DeviceMetadata

Характеристики устройства пользователя.

JSON-представление 
{
  "productName": string,
  "manufacturer": string,
  "deviceClass": string,
  "screenWidthPx": integer,
  "screenHeightPx": integer,
  "nativePlatform": string,
  "screenDensityDpi": integer,
  "glEsVersion": integer,
  "cpuModel": string,
  "cpuMake": string,
  "ramMb": integer
}
Поля
productName

string

Название модели устройства (например, Droid)

manufacturer

string

Производитель устройства (например, Motorola)

deviceClass

string

Класс устройства (например, планшет)

screenWidthPx

integer

Ширина экрана в пикселях

screenHeightPx

integer

Высота экрана в пикселях

nativePlatform

string

Список собственных платформ, разделенных запятыми (например, «arm», «arm7»)

screenDensityDpi

integer

Плотность экрана в DPI

glEsVersion

integer

OpenGL-версия

cpuModel

string

Модель ЦП устройства, например «MSM8974»

cpuMake

string

Марка процессора устройства, например «Qualcomm»

ramMb

integer

Оперативная память устройства в мегабайтах, например «2048»

РазработчикКомментарий

Запись разработчика из разговора между пользователем и разработчиком.

JSON-представление 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
Поля
text

string

Содержание комментария, т. е. тело ответа.

lastModified

object ( Timestamp )

Последний раз, когда этот комментарий обновлялся.

Методы

get

 Получает один отзыв.

list

 Список всех обзоров.

reply

 Отвечает на один отзыв или обновляет существующий ответ.

Коды ошибок

Операции этого ресурса возвращают следующие коды ошибок HTTP:

Код ошибки Причина Разрешение
5xx Общая ошибка на сервере Google Play. Повторите запрос.

Если проблема не устранена, обратитесь к менеджеру своего аккаунта Google Play или отправьте запрос в службу поддержки. Рекомендуем проверить панель состояния Play на наличие известных сбоев.

409 Ошибка параллельного обновления.

Была попытка обновить обновляемый объект. Например, покупка подтверждается вызовом метода acknowledgePurchase() библиотеки Play Billing Library и одновременным вызовом метода purchases.products.acknowledge API Play Developer.

 Повторите запрос.