Business Profile Performance API 现已发布!必须执行迁移工作。
查看弃用时间表以及相关说明,了解如何从旧版 v4 API 迁移到新的 v1 API。
请填写此调查问卷,帮助我们更好地了解您支持哪些商家的地点、菜单和菜品属性,从而帮助我们改善食品菜单体验

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 概览