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 включительно.

Метаданные устройства

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

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:

Код ошибки Причина Описание Разрешение
400 invalidValue В запросе было предоставлено недопустимое значение. Такая ошибка часто возникает при получении некорректного или недействительного токена покупки. Исправьте недопустимое значение поля в теле запроса или параметрах в соответствии со справочником API.
400 required В запросе отсутствует обязательное поле или параметр. Ознакомьтесь с документацией API, чтобы убедиться в наличии всех обязательных полей и параметров.
403 userInsufficientPermission У пользователя недостаточно прав для выполнения запрошенной операции. Убедитесь, что авторизованный пользователь имеет необходимые разрешения в консоли Google Play. Дополнительные сведения см. в разделе «Использование служебной учетной записи» .
404 notFound Запрошенный ресурс не найден. Убедитесь в правильности идентификаторов (например, токен покупки, название пакета, идентификатор продукта, идентификатор подписки).
409 concurrentUpdate Была предпринята попытка обновить объект, который обновляется одновременно с первым. Повторите запрос с экспоненциальной задержкой. Избегайте одновременных изменений одного и того же ресурса.
5xx Generic error Общая ошибка на сервере Google Play. Повторите запрос.

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