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 。可作为排序依据的有效顺序为 rating 、rating desc 和 updateTime 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 概览。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-10-14。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-10-14。"],[[["Retrieves a paginated list of reviews for a specified, verified Google My Business location."],["Allows filtering by page size, page token, and sorting order (rating, rating descending, or update time descending)."],["Returns review details, average rating, total review count, and a token for retrieving subsequent pages if available."],["Requires authorization with specific OAuth scopes for business management."]]],["This content outlines the process of retrieving a paginated list of reviews for a verified location using a `GET` request to a specific URL. The URL utilizes path parameters like `parent` to identify the location. Query parameters such as `pageSize`, `pageToken`, and `orderBy` are used to manage pagination and sorting. The request body is empty. A successful response returns a JSON object containing a list of `reviews`, `averageRating`, `totalReviewCount`, and optionally `nextPageToken` for pagination. Authorization requires specific OAuth scopes.\n"]]