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
(deprecated)

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 Overview

LocationReview

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

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

string

ชื่อทรัพยากรของสถานที่ตั้ง
review

object (Review)

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