Method: accounts.locations.reviews.list

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

คำขอ HTTP

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

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

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

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

string

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

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

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

integer

จำนวนรีวิวที่จะดึงข้อมูลต่อ 1 หน้า 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

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

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

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

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0