REST Resource: accounts.locations.reviews

Tài nguyên: Xem xét

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 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ý vị trí này cho 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ả 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 sao trên tổng số 5 sao.
FOUR 4/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),
  "policyViolation": enum (PolicyViolation)
}
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 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á.
policyViolation

enum (PolicyViolation)

Không bắt buộc. Chỉ có đầu ra. Lỗi vi phạm chính sách dẫn đến việc bị từ chối. Chỉ được điền sẵn nếu reviewReplyState là REJECTED.

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 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.

PolicyViolation

Biểu thị các lỗi vi phạm chính sách được chuẩn hoá. Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng cần chuẩn bị để xử lý các giá trị không xác định.

Enum
POLICY_VIOLATION_UNSPECIFIED Biểu thị một lỗi vi phạm chính sách không xác định.
ACCOUNT_RESTRICTED_AND_SUSPENDED Một Tài khoản Google liên kết với Trang doanh nghiệp này đã bị hạn chế, dẫn đến việc Trang doanh nghiệp bị tạm ngưng.
ACCOUNT_RESTRICTED_AND_EDIT_REJECTED Một Tài khoản Google liên kết với Trang doanh nghiệp này đã bị hạn chế, khiến các nội dung chỉnh sửa bị từ chối. Không giống như ACCOUNT_RESTRICTED_AND_SUSPENDED, Trang doanh nghiệp vẫn hoạt động và không bị tạm ngưng.
ASSOCIATED_ACCOUNT_SUSPENDED Tài khoản Google liên kết với Trang doanh nghiệp này không ở trạng thái tốt. Các Trang doanh nghiệp liên kết với tài khoản đó đã bị tạm ngưng.
BUSINESS_INELIGIBLE Doanh nghiệp của bạn không đủ điều kiện sử dụng Trang doanh nghiệp.
OWNERSHIP_REVOKED Một Tài khoản Google khác đã xác nhận quyền sở hữu Trang doanh nghiệp này. Bạn không thể quản lý trang doanh nghiệp này nữa.
LOCATION_SUSPENDED Trang doanh nghiệp này đã bị tạm ngưng.
LOCATION_DISABLED Trang doanh nghiệp này đã bị vô hiệu hoá.
LOCATION_VERIFICATION_REQUIRED Trang doanh nghiệp này chưa được xác minh.
PO_BOX Trang doanh nghiệp của bạn đã bị tạm ngưng vì địa chỉ doanh nghiệp không được là hộp thư bưu điện.
GOOGLE_PAY_SUSPENSION Các Trang doanh nghiệp liên kết với Hồ sơ thanh toán của bạn đã bị tạm ngưng.
EDITING_RESTRICTION Trang doanh nghiệp này hiện không nhận được thông tin cập nhật công khai. Google đã tắt tính năng chỉnh sửa cho địa điểm này để ngăn chặn nội dung vi phạm chính sách.
ILLEGAL_BUSINESS_HOURS_EDIT Bạn không thể chỉnh sửa giờ hoạt động cho danh mục kinh doanh của mình.
FAKE_ENGAGEMENT Chúng tôi không cho phép nội dung vi phạm chính sách về hoạt động tương tác ảo. Hoạt động tương tác ảo bao gồm nội dung có tặng thưởng, nội dung có mục đích thao túng điểm xếp hạng về một địa điểm và nội dung khác không thể hiện trải nghiệm chân thực.
ADULT_THEMED Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung có chủ đề người lớn. Chủ đề người lớn bao gồm cả nội dung tình dục không phản cảm và nội dung người lớn khác.
SEXUALLY_EXPLICIT Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung khiêu dâm. Nội dung khiêu dâm bao gồm ảnh khoả thân hoặc nội dung mô tả các hoạt động tình dục.
ADVERTISING_AND_SOLICITATION Chúng tôi không cho phép nội dung vi phạm chính sách về hành vi quảng cáo hoặc chào mời. Hành vi quảng cáo và chào mời bao gồm nội dung thương mại hoặc nội dung quảng cáo hay nội dung được đăng để đổi lấy lợi ích.
DANGEROUS Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung nguy hiểm. Nội dung nguy hiểm cổ xuý, tạo điều kiện hoặc khuyến khích việc thực hiện hành động gây hại.
GIBBERISH_AND_REPETITIVE Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung không rõ ràng hoặc lặp lại. Nội dung không rõ ràng hoặc lặp lại làm loãng thông tin hữu ích mà người khác có thể tìm thấy trên Google.
REPETITIVE Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung lặp lại. Nội dung lặp lại bao gồm nội dung giống hệt hoặc tương tự nhau được một hoặc nhiều tài khoản thêm nhiều lần.
UNCLEAR Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung không rõ ràng. Nội dung không rõ ràng bao gồm các ký tự ngẫu nhiên hoặc nội dung khác thiếu ý nghĩa.
ILLEGAL Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung bất hợp pháp.
OFF_TOPIC Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung lạc đề. Nội dung lạc đề bao gồm các bình luận khái quát về chính trị hoặc xã hội và hành vi khoe khoang về cá nhân.
OFFENSIVE Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung phản cảm. Nội dung phản cảm có thể khiến người khác cảm thấy cực kỳ tức giận, bị xúc phạm hoặc không được tôn trọng một cách hợp lý.
VIOLENCE_AND_GORE Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung bạo lực và máu me. Nội dung bạo lực và đẫm máu bao gồm nội dung liên quan đến người hay động vật mang tính cực đoan và mô tả hành vi bạo lực, máu, các bộ phận hoặc nội tạng trên cơ thể một cách chân thực.
CHILD_SAFETY Chúng tôi không cho phép nội dung vi phạm chính sách về sự an toàn cho trẻ em. Nội dung này bao gồm vấn đề khiến trẻ em gặp rủi ro, hành vi bóc lột hay lạm dụng trẻ em, hoặc việc sử dụng các dịch vụ của Google để gây nguy hiểm cho trẻ em.
HARASSMENT Chúng tôi không cho phép nội dung vi phạm chính sách về hành vi quấy rối. Nội dung này bao gồm hành vi bắt nạt, đe doạ, khiêu dâm hoặc khiến một người cảm thấy lo sợ cho sự an toàn của họ.
HATE_SPEECH Chúng tôi không cho phép nội dung vi phạm chính sách về lời nói hận thù. Lời nói hận thù bao gồm việc cổ xuý hoặc dung túng cho hành vi bạo lực, phân biệt đối xử, miệt thị hoặc kích động hận thù dựa trên một đặc điểm được bảo vệ hay các đặc điểm khác liên quan đến hành vi phân biệt đối xử hoặc kỳ thị có hệ thống.
IMPERSONATION Chúng tôi không cho phép nội dung vi phạm chính sách về hành vi mạo danh. Hành vi mạo danh bao gồm việc sử dụng danh tính giả để gây hiểu lầm cho người khác hoặc thu được lợi ích không chính đáng.
MISINFORMATION Chúng tôi không cho phép nội dung vi phạm chính sách về thông tin sai lệch. Thông tin sai lệch bao gồm những thông tin sai sự thật hoặc không chính xác và có thể gây hại đáng kể cho cá nhân, doanh nghiệp hoặc xã hội.
MISREPRESENTATION Chúng tôi không cho phép nội dung vi phạm chính sách về hành vi trình bày sai. Hành vi trình bày sai bao gồm nội dung trình bày gây hiểu nhầm hoặc nội dung không đầy đủ nhằm mục đích thu được lợi ích không chính đáng.
OBSCENITY_AND_PROFANITY Chúng tôi không cho phép nội dung vi phạm chính sách về ngôn từ tục tĩu hoặc ngôn từ thô tục. Ngôn từ thô tục và khiêu dâm bao gồm những từ hoặc cử chỉ bị xem là phản cảm hoặc khiếm nhã trong xã hội theo từng địa phương.
PERSONAL_INFO Chúng tôi không cho phép nội dung vi phạm chính sách về thông tin cá nhân. Thông tin cá nhân bao gồm thông tin riêng tư hoặc thông tin mật, chẳng hạn như chi tiết thẻ tín dụng, bệnh án hoặc giấy tờ tuỳ thân do chính phủ cấp, cho dù đó là thông tin của bạn hay của người khác.
REGULATED_GOODS_AND_SERVICES Chúng tôi không cho phép nội dung vi phạm chính sách về hàng hoá và dịch vụ thuộc diện quản lý. Nội dung này bao gồm lời kêu gọi hành động hoặc ưu đãi để bán các sản phẩm hoặc dịch vụ chịu sự kiểm soát của pháp luật tại địa phương.
GENERIC_VANDALISM Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung lăng mạ hoặc có chất lượng thấp.
GENERIC_FRAUD Chúng tôi không cho phép nội dung vi phạm chính sách về nội dung và hành vi lừa đảo. Nội dung lừa đảo cố ý gây hiểu lầm hoặc lừa gạt người khác.
PHOTOS_AND_VIDEOS_CRITERIA Chúng tôi không cho phép nội dung không tuân thủ các tiêu chí về ảnh và video.
MODERATION_ERROR Đã xảy ra lỗi trong khi xử lý nội dung của bạn.
PRIVACY Chúng tôi không cho phép nội dung vi phạm chính sách quyền riêng tư về Nội dung do người dùng đóng góp trên Maps.
GENERIC_VIOLATION Nội dung của bạn vi phạm các chính sách của Google nên không được phép hiển thị.
GENERIC_QUALITY Chúng tôi không cho phép những nội dung vi phạm chính sách về nội dung chất lượng thấp.
IDENTITY_CHANGE Thay đổi mà bạn thực hiện khác biệt rất nhiều so với doanh nghiệp đã được tạo. Trường hợp này vi phạm chính sách của chúng tôi.
GEOGRAPHIC_LOCATION_CHANGE Cho biết vị trí địa lý thực tế (địa chỉ hoặc vĩ độ/kinh độ) của doanh nghiệp đã thay đổi đáng kể kể từ khi trang doanh nghiệp được tạo.

ReviewMediaItem

Biểu thị một mục nội dung nghe nhìn (ảnh hoặc video) được 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 của 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á đã chỉ định.