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

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

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