Method: accounts.locations.reviews.list

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

Yêu cầu HTTP

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews

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

Tham số đường dẫn

Thông số
parent

string

Tên của địa điểm cần tìm nạp bài đánh giá.

Tham số truy vấn

Thông số
pageSize

integer

Số lượng bài đánh giá cần tìm nạp trên mỗi trang. Số lượng pageSize tối đa là 50.
pageToken

string

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

string

Chỉ định trường để sắp xếp bài đánh giá. Nếu bạn không chỉ định, thứ tự của các 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.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

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

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 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
Trường
reviews[]

object (Review)

Bài đánh giá.
averageRating

number

Điểm xếp hạng trung bình theo sao của tất cả các bài đánh giá cho địa điểm này theo thang điểm từ 1 đến 5, trong đó 5 là điểm xếp hạng cao nhất.
totalReviewCount

integer

Tổng số bài đánh giá về vị trí này.
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 sẵn một mã thông báo để tìm nạp trang bài đánh giá tiếp theo trong một lệnh gọi tiếp theo đến reviews.list. Nếu không còn bài đánh giá nào, 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.