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)
  },
  "reviewMediaItems": [
    {
      object (ReviewMediaItem)
    }
  ]
}
Trường
name

string

Tên tài nguyên. Đối với Bài đánh giá, tên tài nguyê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á.
comment

string

Nội dung 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 thời điểm sửa đổi bài đánh giá lần gần đây nhất.

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 đối với bài đánh giá này.
reviewMediaItems[]

object (ReviewMediaItem)

Chỉ có đầu ra. Các mục nội dung nghe nhìn liên kết với bài đánh giá.

Người đánh giá

Đại diện cho tác giả 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ỉ được điền bằng 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 thang điểm 5 sao, trong đó 5 là điểm xếp hạng cao nhất.

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

ReviewReply

Đại diện cho câu trả lời của chủ sở hữu/người quản lý địa điểm đố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à 4096 byte.
updateTime

string (Timestamp format)

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

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 đối với bài đánh giá. Chỉ có đầu ra.

Trạng thái

Đại diện cho trạng thái kiểm duyệt của một câu trả lời đối với bài đánh giá.

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

ReviewMediaItem

Đại diện cho một mục nội dung nghe nhìn (ảnh hoặc video) liên kết với một bài đánh giá.

Biểu diễn dưới dạng JSON 
{
  "thumbnailUrl": string,
  "thumbnailLabel": string,
  "videoUrl": string
}
Trường
thumbnailUrl

string

Chỉ có đầu ra. URL FIFE cho ảnh hoặc hình thu nhỏ video nếu có videoUrl.
thumbnailLabel

string

Chỉ có đầu ra. Nhãn do tác giả cung cấp cho thumbnailUrl.
videoUrl

string

Chỉ có đầu ra. URL video có thể phá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.