Method: accounts.locations.reviews.list

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

คำขอ HTTP

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

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

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

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

string

ชื่อของสถานที่ตั้งที่จะดึงข้อมูลรีวิว

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

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

integer

จำนวนรีวิวที่จะดึงข้อมูลต่อหน้า pageSize สูงสุดคือ 50 รายการ
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

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0