REST Resource: reviews

资源：Review

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)

来自开发者的评论。

UserComment

用户与开发者对话中的用户条目。

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

在评价经过翻译的情况下，未翻译的评价原文。如果评价未翻译，则此字段为空。

时间戳

Timestamp 表示一个与任何时区或本地日历无关的时间点，其编码形式为包含秒数以及秒数的小数部分（精确到纳秒）的计数。这个计数是以世界协调时间 (UTC) 1970 年 1 月 1 日午夜为纪元的相对数。

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
字段
seconds

string (int64 format)

表示自 Unix 纪元以来的秒数，采用世界协调时间 (UTC)。
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

设备 CPU 型号，例如“MSM8974”
cpuMake

string

设备 CPU 品牌，例如“Qualcomm”
ramMb

integer

设备 RAM（以兆字节为单位），例如“2048”

DeveloperComment

用户与开发者对话中的开发者条目。

JSON 表示法 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
字段
text

string

评论的内容，即回复正文。
lastModified

object (Timestamp)

相应评论最后更新的时间。

方法

get

 获取单条评价。

list

 列出所有评价。

reply

 回复单条评价，或更新单条现有回复。

错误代码

此资源的操作会返回以下 HTTP 错误代码：

错误代码 原因 分辨率
5xx Google Play 服务器中的一般错误。 请重试您的请求。

如果问题仍然存在，请与您的 Google Play 客户经理联系，或提交支持请求。 不妨查看 Play 状态信息中心，了解是否存在任何已知的中断。
409 并发更新错误。

尝试更新正在更新的对象。例如，通过同时调用 Play 结算库的 acknowledgePurchase() 方法和 Play Developer API 的 purchases.products.acknowledge 来确认购买交易。

 请重试您的请求。