Method: publishers.items.fetchReviews

获取某项内容的用户评价。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
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 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

AuthorInfo

评价作者的相关信息。

JSON 表示法 
{
  "displayName": string
}
字段
displayName

string

作者的显示名称。