Method: accounts.locations.reviews.list

แสดงผลรายการรีวิวแบบแบ่งหน้าสำหรับสถานที่ที่ระบุ การดำเนินการนี้จะใช้ได้ก็ต่อเมื่อมีการยืนยันสถานที่ที่ระบุแล้วเท่านั้น

คำขอ HTTP

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ชื่อสถานที่ที่จะดึงรีวิว

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSize

integer

จำนวนรีวิวที่จะดึงข้อมูลต่อหน้า โดยมีจำนวนสูงสุด 50 pageSize
pageToken

string

หากระบุไว้ ระบบจะดึงข้อมูลหน้าถัดไปของรีวิว
orderBy

string

ระบุฟิลด์ที่จะใช้จัดเรียงรีวิว หากไม่ได้ระบุไว้ ลำดับของรีวิวที่แสดงจะใช้ค่าเริ่มต้นเป็น updateTime desc ลำดับที่ถูกต้องในการจัดเรียงคือ rating, rating desc และ updateTime desc

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ Reviews.ListReviews

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
ช่อง
reviews[]

object (Review)

รีวิว
averageRating

number

คะแนนดาวโดยเฉลี่ยของรีวิวทั้งหมดสำหรับสถานที่ตั้งนี้ในระดับ 1 ถึง 5 โดย 5 คือคะแนนสูงสุด
totalReviewCount

integer

จำนวนรีวิวทั้งหมดของสถานที่นี้
nextPageToken

string

หากจำนวนรีวิวเกินขนาดหน้าเว็บที่ขอ ระบบจะป้อนข้อมูลในช่องนี้ด้วยโทเค็นเพื่อดึงข้อมูลรีวิวหน้าถัดไปในการเรียกใช้ reviews.list ครั้งต่อๆ ไป หากไม่มีรีวิวเพิ่มเติม ฟิลด์นี้จะไม่ปรากฏในการตอบกลับ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview