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 错误代码：

错误代码 原因 说明 分辨率
400 invalidValue 请求中提供的值无效。如果购买令牌格式有误或无效，系统通常会返回此错误。 根据 API 参考文档，更正请求正文或参数中的无效字段值。
400 required 请求中缺少必需的字段或参数。 请参阅 API 文档，确保包含所有必填字段和参数。
403 userInsufficientPermission 用户没有足够的权限来执行所请求的操作。 确保经过身份验证的用户在 Google Play 管理中心内拥有必要的权限。如需了解详情，请参阅 使用服务账号。
404 notFound 找不到所请求的资源。 验证标识符（例如购买令牌、软件包名称、商品 ID、订阅 ID）是否正确。
409 concurrentUpdate 尝试更新正在并发更新的对象。 使用指数退避算法重试请求。避免同时修改同一资源。
5xx Generic error Google Play 服务器中的一般错误。 请重试您的请求。

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