- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi cấp phép
Trả về danh sách bài đánh giá được đánh số trang cho vị trí được chỉ định. Thao tác này chỉ hợp lệ nếu vị trí đã 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
Tham số | |
---|---|
parent |
Tên của vị trí để tìm nạp bài đánh giá. |
Tham số truy vấn
Tham số | |
---|---|
pageSize |
Số bài đánh giá cần tìm nạp trên mỗi trang. |
pageToken |
Nếu được chỉ định, Google sẽ tìm nạp trang tiếp theo của bài đánh giá. |
orderBy |
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à |
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
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.ListReview.
Biểu diễn dưới dạng JSON | |
---|---|
{
"reviews": [
{
object ( |
Trường | |
---|---|
reviews[] |
Bài đánh giá. |
averageRating |
Điểm xếp hạng trung bình theo sao của tất cả bài đánh giá cho địa điểm này trên thang điểm từ 1 đến 5, trong đó 5 là điểm xếp hạng cao nhất. |
totalReviewCount |
Tổng số bài đánh giá về địa điểm này. |
nextPageToken |
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 lệnh gọi tiếp theo đến reviews.list. Nếu không có bài đánh giá nào khác, thì 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.