Method: accounts.locations.batchGetReviews

Trả về danh sách bài đánh giá được phân trang cho tất cả vị trí được chỉ định. Thao tác này chỉ hợp lệ nếu các vị trí đã chỉ định được xác minh.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Tên của tài khoản để truy xuất danh sách bài đánh giá ở nhiều vị trí.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
Trường
locationNames[]

string

Tập hợp các vị trí để tìm thông tin đánh giá, được chỉ định theo tên vị trí.
pageSize

integer

Số bài đánh giá cần tìm nạp trên mỗi trang. Giá trị mặc định là 50.
pageToken

string

Nếu được chỉ định, Google sẽ tìm nạp trang tiếp theo của bài đánh giá.
orderBy

string

Không bắt buộc. Chỉ định trường để sắp xếp bài đánh giá. Nếu bạn chưa chỉ định, thứ tự của các bài đánh giá được trả về sẽ mặc định là updateTime desc. Các đơn đặt hàng hợp lệ để sắp xếp là rating, rating desc và updateTime desc. rating sẽ trả về các bài đánh giá theo thứ tự tăng dần. updateTime(tức là thứ tự tăng dần) không được hỗ trợ.
ignoreRatingOnlyReviews

boolean

Liệu có bỏ qua các bài đánh giá chỉ xếp hạng hay không.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Thông báo phản hồi cho Reviews.BatchGetĐánh giá.

Biểu diễn dưới dạng JSON 
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
Trường
locationReviews[]

object (LocationReview)

Bài đánh giá kèm thông tin vị trí.
nextPageToken

string

Nếu số lượng bài đánh giá vượt quá kích thước trang đã yêu cầu, thì trường này sẽ được điền sẵn một mã thông báo để tìm nạp trang tiếp theo của các bài đánh giá trong các lệnh gọi tiếp theo. Nếu không có bài đánh giá nào khác, trường này sẽ không xuất hiện trong câu trả lời.

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

LocationReview

Biểu thị một bài đánh giá có thông tin vị trí.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "review": {
    object (Review)
  }
}
Trường
name

string

Tên tài nguyên vị trí.
review

object (Review)

Bài đánh giá về vị trí đó.