REST Resource: accounts.locations.reviews

Tài nguyên: Bài đánh giá

Chỉ có đầu ra. Đại diện cho một bài đánh giá về một địa điểm.

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. Đối với trạng thái Cần xem xét, mã này 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á.

comment

string

Nội dung của bài đánh giá ở dạng văn bản thuần tuý có phần đánh dấu.

createTime

string (Timestamp format)

Dấu thời gian cho biết thời điểm viết bài đánh giá.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Dấu thời gian cho biết lần gần đây nhất bài đánh giá được sửa đổi.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

reviewReply

object (ReviewReply)

Câu trả lời của chủ sở hữu/người quản lý địa điểm 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 sẵ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à false.

isAnonymous

boolean

Cho biết liệu người đánh giá có chọn ẩn danh hay không.

StarRating

Điểm xếp hạng theo sao trên 5 sao, trong đó 5 là điểm xếp hạng cao nhất.

Enum
STAR_RATING_UNSPECIFIED Chưa chỉ định.
ONE 1/5 sao.
TWO Hai sao trên tối đa năm sao.
THREE 3/5 sao.
FOUR 4 sao trên tổng số 5 sao.
FIVE Điểm xếp hạng tối đa theo sao.

ReviewReply

Đại diện cho câu trả lời của chủ sở hữu/người quản lý vị trí đối với một bài đánh giá.

Biểu diễn dưới dạng JSON
{
  "comment": string,
  "updateTime": string,
  "reviewReplyState": enum (State)
}
Trường
comment

string

Nội dung thư trả lời ở dạng văn bản thuần tuý có phần đánh dấu. Độ dài tối đa là 4.096 byte.

updateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian cho biết lần gần đây nhất câu trả lời được sửa đổi.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

reviewReplyState

enum (State)

Chỉ có đầu ra. Trạng thái của câu trả lời cho bài đánh giá.

Tiểu bang

Biểu thị trạng thái kiểm duyệt của câu trả lời cho bài đánh giá.

Enum
REVIEW_REPLY_STATE_UNSPECIFIED Cho biết rằng trạng thái chưa được chỉ định.
PENDING Cho biết rằng câu trả lời đang chờ kiểm duyệt.
REJECTED Cho biết rằng câu trả lời đã bị từ chối.
APPROVED Cho biết rằng câu trả lời đã được phê duyệt.

Phương thức

deleteReply

Xoá câu trả lời cho bài đánh giá được chỉ định.

get

Trả về bài đánh giá được chỉ định.

list

Trả về danh sách bài đánh giá được phân trang cho địa điểm được chỉ định.

updateReply

Cập nhật câu trả lời cho bài đánh giá được chỉ định.