REST Resource: accounts.locations.reviews

แหล่งข้อมูล: ตรวจสอบ

เอาต์พุตเท่านั้น แสดงรีวิวสำหรับสถานที่

การแสดง JSON 
{
  "name": string,
  "reviewId": string,
  "reviewer": {
    object (Reviewer)
  },
  "starRating": enum (StarRating),
  "comment": string,
  "createTime": string,
  "updateTime": string,
  "reviewReply": {
    object (ReviewReply)
  },
  "reviewMediaItems": [
    {
      object (ReviewMediaItem)
    }
  ]
}
ช่อง
name

string

ชื่อทรัพยากร สำหรับรีวิว จะอยู่ในรูปแบบ accounts/{accountId}/locations/{locationId}/reviews/{reviewId}
reviewId

string

ตัวระบุที่ไม่ซ้ำกันที่เข้ารหัส
reviewer

object (Reviewer)

ผู้เขียนรีวิว
starRating

enum (StarRating)

การให้ดาวของรีวิว
comment

string

เนื้อหาของรีวิวแบบข้อความธรรมดาพร้อมมาร์กอัป
createTime

string (Timestamp format)

การประทับเวลาที่เขียนรีวิว

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

การประทับเวลาเมื่อมีการแก้ไขรีวิวครั้งล่าสุด

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
reviewReply

object (ReviewReply)

คำตอบของเจ้าของ/ผู้จัดการสถานที่นี้ต่อรีวิวนี้
reviewMediaItems[]

object (ReviewMediaItem)

เอาต์พุตเท่านั้น รายการสื่อที่เชื่อมโยงกับรีวิว

ผู้เขียนรีวิว

แสดงถึงผู้เขียนรีวิว

การแสดง JSON 
{
  "profilePhotoUrl": string,
  "displayName": string,
  "isAnonymous": boolean
}
ช่อง
profilePhotoUrl

string

ลิงก์รูปโปรไฟล์ของผู้รีวิว จะป้อนข้อมูลเฉพาะในกรณีที่ isAnonymous เป็นเท็จ
displayName

string

ชื่อของผู้รีวิว จะแสดงชื่อจริงของผู้รีวิวก็ต่อเมื่อ isAnonymous เป็นเท็จเท่านั้น
isAnonymous

boolean

ระบุว่าผู้รีวิวเลือกที่จะไม่ระบุตัวตนหรือไม่

StarRating

การให้ดาวจาก 5 ดาว โดย 5 ดาวคือคะแนนสูงสุด

Enum
STAR_RATING_UNSPECIFIED ไม่ได้ระบุ
ONE 1 ดาวจากสูงสุด 5 ดาว
TWO 2 ดาวจากสูงสุด 5 ดาว
THREE 3 ดาวจากสูงสุด 5 ดาว
FOUR 4 ดาวจากสูงสุด 5 ดาว
FIVE การให้ดาวสูงสุด

ReviewReply

แสดงการตอบกลับรีวิวของเจ้าของ/ผู้จัดการสถานที่

การแสดง JSON 
{
  "comment": string,
  "updateTime": string,
  "reviewReplyState": enum (State),
  "policyViolation": enum (PolicyViolation)
}
ช่อง
comment

string

เนื้อหาของข้อความตอบกลับแบบข้อความธรรมดาพร้อมมาร์กอัป ความยาวสูงสุดคือ 4096 ไบต์
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาเมื่อมีการแก้ไขคำตอบครั้งล่าสุด

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
reviewReplyState

enum (State)

เอาต์พุตเท่านั้น สถานะของคำตอบต่อรีวิว
policyViolation

enum (PolicyViolation)

ไม่บังคับ เอาต์พุตเท่านั้น การละเมิดนโยบายที่ส่งผลให้ถูกปฏิเสธ จะป้อนข้อมูลก็ต่อเมื่อ reviewReplyState เป็น REJECTED

รัฐ

แสดงสถานะการกลั่นกรองของการตอบกลับรีวิว

Enum
REVIEW_REPLY_STATE_UNSPECIFIED ระบุว่าไม่ได้ระบุสถานะ
PENDING แสดงว่าการตอบกลับอยู่ระหว่างรอการกลั่นกรอง
REJECTED ระบุว่าการตอบกลับถูกปฏิเสธ
APPROVED แสดงว่าการตอบกลับได้รับการอนุมัติแล้ว

PolicyViolation

แสดงการละเมิดนโยบายที่เป็นมาตรฐาน ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต ไคลเอ็นต์ควรเตรียมพร้อมที่จะจัดการค่าที่ไม่รู้จัก

Enum
POLICY_VIOLATION_UNSPECIFIED แสดงถึงการละเมิดนโยบายที่ไม่ได้ระบุ
ACCOUNT_RESTRICTED_AND_SUSPENDED บัญชี Google ที่เชื่อมโยงกับ Business Profile นี้ถูกจํากัดการใช้งาน ซึ่งส่งผลให้ Business Profile ถูกระงับ
ACCOUNT_RESTRICTED_AND_EDIT_REJECTED บัญชี Google ที่เชื่อมโยงกับ Business Profile นี้ถูกจํากัดการใช้งาน ทําให้ระบบปฏิเสธการแก้ไข Business Profile จะยังคงใช้งานได้และไม่ถูกระงับ ซึ่งต่างจาก ACCOUNT_RESTRICTED_AND_SUSPENDED
ASSOCIATED_ACCOUNT_SUSPENDED บัญชี Google ที่เชื่อมโยงกับ Business Profile นี้ไม่อยู่ในสถานะดี Business Profile ที่เชื่อมโยงกับบัญชีดังกล่าวถูกระงับ
BUSINESS_INELIGIBLE ธุรกิจของคุณไม่มีสิทธิ์ใช้ Business Profile
OWNERSHIP_REVOKED บัญชี Google อีกบัญชีหนึ่งอ้างสิทธิ์ Business Profile นี้ คุณไม่สามารถจัดการโปรไฟล์นี้ได้อีกต่อไป
LOCATION_SUSPENDED Business Profile นี้ถูกระงับ
LOCATION_DISABLED ปิดใช้ Business Profile นี้แล้ว
LOCATION_VERIFICATION_REQUIRED Business Profile นี้ไม่ได้รับการยืนยัน
PO_BOX Business Profile ของคุณถูกระงับเนื่องจากที่อยู่ธุรกิจไม่สามารถใช้ตู้ ปณ. ได้
GOOGLE_PAY_SUSPENSION Business Profile ที่เชื่อมโยงกับโปรไฟล์การชำระเงินของคุณถูกระงับ
EDITING_RESTRICTION ขณะนี้ Business Profile นี้ถูกจำกัดไม่ให้รับข้อมูลอัปเดตแบบสาธารณะ Google ได้ปิดการแก้ไขสำหรับสถานที่นี้เพื่อป้องกันเนื้อหาที่ละเมิดนโยบาย
ILLEGAL_BUSINESS_HOURS_EDIT หมวดหมู่ธุรกิจของคุณไม่สามารถแก้ไขเวลาทําการ
FAKE_ENGAGEMENT เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับการมีส่วนร่วมที่ไม่ได้เกิดขึ้นจริง การมีส่วนร่วมที่ไม่ได้เกิดขึ้นจริง ได้แก่ เนื้อหาจูงใจ เนื้อหาที่มีเจตนาปั่นคะแนนของสถานที่ และเนื้อหาอื่นๆ ที่ไม่ได้แสดงถึงประสบการณ์จริง
ADULT_THEMED เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับเนื้อหาที่มีธีมสำหรับผู้ใหญ่ ธีมสำหรับผู้ใหญ่คือเนื้อหาเกี่ยวกับเรื่องเพศที่ไม่โจ่งแจ้งและเนื้อหาสำหรับผู้ใหญ่อื่นๆ
SEXUALLY_EXPLICIT เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเนื้อหาเกี่ยวกับเรื่องเพศอย่างโจ่งแจ้ง เนื้อหาเกี่ยวกับเรื่องเพศอย่างโจ่งแจ้งคือภาพอวัยวะเพศเปลือยหรือการแสดงภาพหรือคําอธิบายกิจกรรมทางเพศ
ADVERTISING_AND_SOLICITATION เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับการโฆษณาหรือการชักชวน การโฆษณาและการชักชวนคือเนื้อหาส่งเสริมการขายหรือเชิงพาณิชย์ หรือเนื้อหาที่โพสต์เพื่อแลกกับผลประโยชน์
DANGEROUS เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับเนื้อหาที่เป็นอันตราย เนื้อหาที่เป็นอันตรายคือเนื้อหาที่ส่งเสริม สนับสนุน หรือก่อให้เกิดการกระทําที่เป็นอันตราย
GIBBERISH_AND_REPETITIVE เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับเนื้อหาซ้ำหรือไม่ชัดเจน เนื่องจากทำให้ผู้ใช้ไม่ได้รับข้อมูลที่เป็นประโยชน์อย่างที่ควรใน Google
REPETITIVE เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับเนื้อหาซ้ำ เนื้อหาซ้ำรวมถึงเนื้อหาที่เหมือนหรือคล้ายกันซึ่งมีการเพิ่มหลายครั้งจากบัญชีอย่างน้อย 1 บัญชี
UNCLEAR เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับเนื้อหาที่ไม่ชัดเจน เนื้อหาที่ไม่ชัดเจนรวมถึงอักขระแบบสุ่มหรือเนื้อหาอื่นๆ ที่ไม่มีความหมาย
ILLEGAL เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเนื้อหาที่ผิดกฎหมาย
OFF_TOPIC เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับเนื้อหาที่ไม่ตรงประเด็น เนื้อหาที่ไม่ตรงประเด็นคือความคิดเห็นทั่วไป ความคิดเห็นเกี่ยวกับการเมืองหรือสังคม และการระบายความรู้สึกส่วนตัว
OFFENSIVE เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับเนื้อหาที่ทำให้เกิดความไม่พอใจ เนื้อหาที่ทำให้เกิดความไม่พอใจอาจทําให้ผู้อื่นรู้สึกถึงความโกรธ การดูหมิ่น หรือการเหยียดหยามอย่างรุนแรง
VIOLENCE_AND_GORE เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับความรุนแรงและการนองเลือด ความรุนแรงหรือการนองเลือดคือเนื้อหาเกี่ยวกับคนหรือสัตว์ซึ่งสุดโต่งและแสดงการกระทําที่รุนแรง เลือด ชิ้นส่วนร่างกาย หรืออวัยวะภายในอย่างสมจริง
CHILD_SAFETY เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับความปลอดภัยของเด็ก ซึ่งรวมถึงเนื้อหาที่ทําให้เด็กมีความเสี่ยง แสวงหาประโยชน์หรือล่วงละเมิดเด็ก หรือใช้บริการของ Google เพื่อทําให้เด็กตกอยู่ในอันตราย
HARASSMENT เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับการคุกคาม ซึ่งรวมถึงเนื้อหาที่กลั่นแกล้ง ข่มขู่ กล่าวถึงในทางเพศ หรือทําให้บุคคลกลัวว่าจะเกิดความไม่ปลอดภัย
HATE_SPEECH เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับวาจาสร้างความเกลียดชัง วาจาสร้างความเกลียดชังคือการส่งเสริมหรือยอมรับการใช้ความรุนแรง การเลือกปฏิบัติ การดูหมิ่น หรือการยุยงให้เกิดความเกลียดชังต่อบุคคลหรือกลุ่มบุคคลอันเนื่องมาจากลักษณะที่ได้รับการคุ้มครอง หรือลักษณะอื่นๆ ที่เกี่ยวข้องกับการเลือกปฏิบัติเชิงโครงสร้างหรือทำให้สถานะของบุคคลนั้นๆ ลดลงหรือต่ำกว่ากลุ่มอื่น
IMPERSONATION เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับการแอบอ้างเป็นบุคคลอื่น การแอบอ้างเป็นบุคคลอื่นคือการใช้ข้อมูลประจําตัวปลอมเพื่อทําให้ผู้อื่นเข้าใจผิดหรือตนได้รับประโยชน์โดยมิชอบ
MISINFORMATION เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับการให้ข้อมูลที่ไม่ถูกต้อง การให้ข้อมูลที่ไม่ถูกต้องคือการให้ข้อมูลเท็จหรือข้อมูลที่ไม่ถูกต้องซึ่งอาจก่อให้เกิดอันตรายร้ายแรงต่อบุคคล ธุรกิจ หรือสังคม
MISREPRESENTATION เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับการสื่อให้เข้าใจผิด การสื่อให้เข้าใจผิดคือการนำเสนอหรือการละเว้นที่สื่อให้เข้าใจผิดซึ่งมีจุดประสงค์เพื่อให้ได้รับประโยชน์โดยมิชอบ
OBSCENITY_AND_PROFANITY เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับคําลามกหรือคําหยาบคาย เนื้อหาลามกและหยาบคายคือเนื้อหาที่มีคําหรือท่าทางที่คนในท้องถิ่นถือว่าเป็นสิ่งที่ไม่เหมาะสมหรือหยาบคายในทางสังคม
PERSONAL_INFO เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับข้อมูลส่วนบุคคล ข้อมูลส่วนบุคคลคือข้อมูลส่วนตัวหรือข้อมูลลับ เช่น รายละเอียดบัตรเครดิต เวชระเบียน หรือบัตรประจําตัวที่ทางการออกให้ ไม่ว่าจะเป็นของคุณเองหรือของผู้อื่น
REGULATED_GOODS_AND_SERVICES เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับสินค้าและบริการที่มีการควบคุม ซึ่งรวมถึงคำกระตุ้นให้ดำเนินการ (Call-To-Action) หรือข้อเสนอสำหรับการขายผลิตภัณฑ์หรือบริการที่อยู่ภายใต้กฎระเบียบทางกฎหมายของท้องถิ่น
GENERIC_VANDALISM เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับเนื้อหาที่เป็นการละเมิดหรือมีคุณภาพต่ำ
GENERIC_FRAUD เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับเนื้อหาและพฤติกรรมที่หลอกลวง เนื้อหาหลอกลวงคือเนื้อหาที่มีเจตนาหลอกลวงผู้อื่นหรือก่อให้เกิดความเข้าใจผิด
PHOTOS_AND_VIDEOS_CRITERIA เราไม่อนุญาตให้แสดงเนื้อหาที่ไม่เป็นไปตามเกณฑ์รูปภาพและวิดีโอ
MODERATION_ERROR เกิดข้อผิดพลาดขณะประมวลผลเนื้อหา
PRIVACY เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายความเป็นส่วนตัวของเนื้อหาจากผู้ใช้ Maps
GENERIC_VIOLATION เนื้อหาของคุณละเมิดนโยบายและไม่ได้รับอนุญาตให้แสดง
GENERIC_QUALITY เราไม่อนุญาตให้แสดงเนื้อหาที่ละเมิดนโยบายเกี่ยวกับเนื้อหาที่มีคุณภาพต่ำ
IDENTITY_CHANGE การเปลี่ยนแปลงที่คุณทำแตกต่างจากธุรกิจที่สร้างขึ้นมาก การกระทำนี้ละเมิดนโยบายของเรา
GEOGRAPHIC_LOCATION_CHANGE ระบุว่าสถานที่ตั้งทางภูมิศาสตร์จริง (ที่อยู่หรือละติจูด/ลองจิจูด) ของธุรกิจมีการเปลี่ยนแปลงอย่างมากนับตั้งแต่สร้างโปรไฟล์

ReviewMediaItem

แสดงรายการสื่อ (รูปภาพหรือวิดีโอ) ที่เชื่อมโยงกับรีวิว

การแสดง JSON 
{
  "thumbnailUrl": string,
  "thumbnailLabel": string,
  "videoUrl": string
}
ช่อง
thumbnailUrl

string

เอาต์พุตเท่านั้น URL ของ FIFE สำหรับรูปภาพหรือภาพปกวิดีโอ หากมี videoUrl
thumbnailLabel

string

เอาต์พุตเท่านั้น ป้ายกำกับที่ผู้แต่งระบุสำหรับ thumbnailUrl
videoUrl

string

เอาต์พุตเท่านั้น URL ของวิดีโอที่เล่นได้

เมธอด

deleteReply

 ลบคำตอบของรีวิวที่ระบุ

get

 แสดงรีวิวที่ระบุ

list

 แสดงผลรายการรีวิวแบบแบ่งหน้าสำหรับสถานที่ที่ระบุ

updateReply

 อัปเดตคำตอบสำหรับรีวิวที่ระบุ