Method: accounts.locations.batchGetReviews

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

คำขอ HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGetReviews

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

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

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

string

ชื่อบัญชีที่ต้องการใช้เรียกดูรายการรีวิวในสถานที่ต่างๆ

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
ช่อง
locationNames[]

string

คอลเล็กชันของสถานที่ตั้งที่จะดึงข้อมูลรีวิว โดยระบุชื่อสถานที่
pageSize

integer

จำนวนรีวิวที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นคือ 50
pageToken

string

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

string

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

boolean

เลือกว่าจะไม่สนใจรีวิวที่เป็นการให้คะแนนเท่านั้นหรือไม่

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

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

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

การแสดง JSON 
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
ช่อง
locationReviews[]

object (LocationReview)

รีวิวที่มีข้อมูลสถานที่ตั้ง
nextPageToken

string

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

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

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

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

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

LocationReview

แสดงรีวิวที่มีข้อมูลสถานที่ตั้ง

การแสดง JSON 
{
  "name": string,
  "review": {
    object (Review)
  }
}
ช่อง
name

string

ชื่อทรัพยากรของตำแหน่ง
review

object (Review)

รีวิวสำหรับสถานที่