Method: accounts.locations.batchGetReviews

Trả về danh sách bài đánh giá được phân trang cho tất cả các vị trí được chỉ định. Thao tác này chỉ hợp lệ nếu các vị trí được 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

Thông số
name

string

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với 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

Một tập hợp các vị trí để tìm nạp bài đánh giá, được chỉ định theo tên.
pageSize

integer

Số lượng 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, thì sẽ tìm nạp trang bài đánh giá tiếp theo.
orderBy

string

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

boolean

Có bỏ qua bài đánh giá chỉ có điểm xếp hạng hay không.

Nội dung phản hồi

Thông báo phản hồi cho Reviews.BatchGetReviews.

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:

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

object (LocationReview)

Bài đánh giá có thông tin vị trí.
nextPageToken

string

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

Phạm vi uỷ quyền

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 OAuth 2.0 Overview.

LocationReview

Đại diện cho 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í.