REST Resource: accounts.locations.reviews
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: Đánh giá
Chỉ có đầu ra. Biểu thị bài đánh giá cho một vị trí.
| Biểu diễn dưới dạng JSON |
{
"name": string,
"reviewId": string,
"reviewer": {
object (Reviewer)
},
"starRating": enum (StarRating),
"comment": string,
"createTime": string,
"updateTime": string,
"reviewReply": {
object (ReviewReply)
}
} |
| Trường |
name |
string
Tên tài nguyên. Để được xem xét, nó có dạng accounts/{accountId}/locations/{locationId}/reviews/{reviewId}
|
reviewId |
string
Giá trị nhận dạng duy nhất đã mã hoá.
|
reviewer |
object (Reviewer)
Tác giả bài đánh giá.
|
starRating |
enum (StarRating)
Điểm xếp hạng theo sao của bài đánh giá.
|
createTime |
string (Timestamp format)
Dấu thời gian khi bài đánh giá được viết. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
|
updateTime |
string (Timestamp format)
Dấu thời gian của thời điểm sửa đổi gần đây nhất của bài đánh giá. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
|
reviewReply |
object (ReviewReply)
Chủ sở hữu/người quản lý trả lời của vị trí này cho bài đánh giá này.
|
Người đánh giá
Đại diện cho tác giả của bài đánh giá.
| Biểu diễn dưới dạng JSON |
{
"profilePhotoUrl": string,
"displayName": string,
"isAnonymous": boolean
} |
| Trường |
profilePhotoUrl |
string
Đường liên kết đến ảnh hồ sơ của người đánh giá. Chỉ được điền nếu isAnonymous là false.
|
displayName |
string
Tên của người đánh giá. Chỉ điền tên thật của người đánh giá nếu isAnonymous là giá trị false.
|
isAnonymous |
boolean
Cho biết liệu người đánh giá có chọn tiếp tục ẩn danh hay không.
|
StarRating
Điểm xếp hạng theo sao trên 5 sao, trong đó 5 sao là điểm xếp hạng cao nhất.
| Enum |
STAR_RATING_UNSPECIFIED |
Chưa chỉ định. |
ONE |
1 trên 5 sao. |
TWO |
Tối đa 2 sao trong tổng số 5 sao. |
THREE |
Tối đa 3 sao trong tổng số 5 sao. |
FOUR |
Tối đa 4 sao trong tổng số 5 sao. |
FIVE |
Điểm xếp hạng theo sao tối đa. |
ReviewReply
Thể hiện nội dung trả lời của chủ sở hữu/người quản lý vị trí cho bài đánh giá.
| Biểu diễn dưới dạng JSON |
{
"comment": string,
"updateTime": string
} |
| Trường |
updateTime |
string (Timestamp format)
Chỉ có đầu ra. Dấu thời gian sửa đổi lần gần đây nhất câu trả lời. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
|
Phương thức |
|
|
Xoá câu trả lời cho bài đánh giá đã chỉ định. |
|
|
Trả về kết quả xem lại đã chỉ định. |
|
|
Trả về danh sách bài đánh giá được đánh số trang cho vị trí được chỉ định. |
|
|
Cập nhật câu trả lời cho bài đánh giá đã chỉ định. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis document outlines the structure and properties of a Google My Business review, including details about the reviewer, star rating, and any replies.\u003c/p\u003e\n"],["\u003cp\u003eReviews can be retrieved, listed, and have their replies updated or deleted using the provided methods.\u003c/p\u003e\n"],["\u003cp\u003eReview data includes timestamps for creation and updates, as well as the review text and star rating.\u003c/p\u003e\n"],["\u003cp\u003eReviewers can choose to remain anonymous, impacting the visibility of their profile information.\u003c/p\u003e\n"],["\u003cp\u003eLocation owners/managers can reply to reviews, and these replies also have timestamps for tracking modifications.\u003c/p\u003e\n"]]],["This document details the structure of location reviews, including the review itself, the reviewer, and any replies. A review includes a `reviewId`, `starRating`, textual `comment`, and timestamps for creation and updates. The reviewer has a `displayName`, `profilePhotoUrl`, and anonymity status. The reply includes a `comment` and its last update time. The document also outlines methods to delete, get, list, and update replies to reviews.\n"],null,["# REST Resource: accounts.locations.reviews\n\n- [Resource: Review](#Review)\n - [JSON representation](#Review.SCHEMA_REPRESENTATION)\n- [Reviewer](#Reviewer)\n - [JSON representation](#Reviewer.SCHEMA_REPRESENTATION)\n- [StarRating](#StarRating)\n- [ReviewReply](#ReviewReply)\n - [JSON representation](#ReviewReply.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Review\n----------------\n\nOutput only. Represents a review for a location.\n\n| JSON representation ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"reviewId\": string, \"reviewer\": { object (/my-business/reference/rest/v4/accounts.locations.reviews#Reviewer) }, \"starRating\": enum (/my-business/reference/rest/v4/accounts.locations.reviews#StarRating), \"comment\": string, \"createTime\": string, \"updateTime\": string, \"reviewReply\": { object (/my-business/reference/rest/v4/accounts.locations.reviews#ReviewReply) } } ``` |\n\n| Fields ||\n|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name. For Review it is of the form `accounts/{accountId}/locations/{locationId}/reviews/{reviewId}` |\n| `reviewId` | `string` The encrypted unique identifier. |\n| `reviewer` | `object (`[Reviewer](/my-business/reference/rest/v4/accounts.locations.reviews#Reviewer)`)` The author of the review. |\n| `starRating` | `enum (`[StarRating](/my-business/reference/rest/v4/accounts.locations.reviews#StarRating)`)` The star rating of the review. |\n| `comment` | `string` The body of the review as plain text with markups. |\n| `createTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` The timestamp for when the review was written. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `updateTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` The timestamp for when the review was last modified. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `reviewReply` | `object (`[ReviewReply](/my-business/reference/rest/v4/accounts.locations.reviews#ReviewReply)`)` The owner/manager of this location's reply to this review. |\n\nReviewer\n--------\n\nRepresents the author of the review.\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------|---|\n| ``` { \"profilePhotoUrl\": string, \"displayName\": string, \"isAnonymous\": boolean } ``` |\n\n| Fields ||\n|-------------------|------------------------------------------------------------------------------------------------------------|\n| `profilePhotoUrl` | `string` The profile photo link of the reviewer. Only populated if `isAnonymous` is false. |\n| `displayName` | `string` The name of the reviewer. Only populated with the reviewer's real name if `isAnonymous` is false. |\n| `isAnonymous` | `boolean` Indicates whether the reviewer has opted to remain anonymous. |\n\nStarRating\n----------\n\nThe star rating out of five, where five is the highest rated.\n\n| Enums ||\n|---------------------------|---------------------------------------|\n| `STAR_RATING_UNSPECIFIED` | Not specified. |\n| `ONE` | One star out of a maximum of five. |\n| `TWO` | Two stars out of a maximum of five. |\n| `THREE` | Three stars out of a maximum of five. |\n| `FOUR` | Four stars out of a maximum of five. |\n| `FIVE` | The maximum star rating. |\n\nReviewReply\n-----------\n\nRepresents the location owner/manager's reply to a review.\n\n| JSON representation ||\n|-----------------------------------------------------|---|\n| ``` { \"comment\": string, \"updateTime\": string } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `comment` | `string` The body of the reply as plain text with markups. The maximum length is 4096 bytes. |\n| `updateTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Output only. The timestamp for when the reply was last modified. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------|-------------------------------------------------------------------|\n| ### [deleteReply](/my-business/reference/rest/v4/accounts.locations.reviews/deleteReply) | Deletes the response to the specified review. |\n| ### [get](/my-business/reference/rest/v4/accounts.locations.reviews/get) | Returns the specified review. |\n| ### [list](/my-business/reference/rest/v4/accounts.locations.reviews/list) | Returns the paginated list of reviews for the specified location. |\n| ### [updateReply](/my-business/reference/rest/v4/accounts.locations.reviews/updateReply) | Updates the reply to the specified review. |"]]
