Method: accounts.locations.reviews.list

返回指定营业地点的分页评价列表。仅当指定营业地点通过验证后,此操作才有效。

HTTP 请求

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

要获取其评价的营业地点的名称。

查询参数

参数
pageSize

integer

每页可获取的评价数量。pageSize 的最大值为 50。

pageToken

string

如果指定,则获取下一页评价。

orderBy

string

指定用于对评价进行排序的字段。如果未指定,返回的评价顺序将默认为 updateTime desc。可作为排序依据的有效顺序为 ratingrating descupdateTime desc

请求正文

请求正文必须为空。

响应正文

如果成功,响应正文将包含结构如下的数据:

Reviews.ListReviews 的响应消息。

JSON 表示法
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
字段
reviews[]

object (Review)

评价。

averageRating

number

此营业地点获得的所有评价的平均星级,分值范围为 1 到 5 星,其中 5 星为最高评分。

totalReviewCount

integer

此营业地点获得的评价总数。

nextPageToken

string

如果评价数量超过所请求的页面大小,系统会使用令牌填充此字段,以在后续调用 reviews.list 时获取下一页评价。如果没有其他评价,则响应中不会显示此字段。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

如需了解详情,请参阅 OAuth 2.0 概览