Trả về danh sách các bài đánh giá được phân trang cho tất cả các vị trí đã chỉ định. Thao tác này chỉ hợp lệ nếu các vị trí mà bạn 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
Các tham số | |
---|---|
name |
Tên của tài khoản dùng để truy xuất danh sách các bài đánh giá ở nhiều địa điểm. |
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 } |
Các trường | |
---|---|
locationNames[] |
Tập hợp các địa điểm để tìm nạp bài đánh giá, được xác định theo tên của các địa điểm đó. |
pageSize |
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 |
Nếu được chỉ định, thẻ này sẽ tìm nạp trang bài đánh giá tiếp theo. |
orderBy |
Không bắt buộc. Chỉ định trường để sắp xếp bài đánh giá theo. Nếu không chỉ định, thứ tự của các bài đánh giá được trả về sẽ mặc định là |
ignoreRatingOnlyReviews |
Có bỏ qua 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.BatchGetChallenge.
Biểu diễn dưới dạng JSON | |
---|---|
{
"locationReviews": [
{
object ( |
Các trường | |
---|---|
locationReviews[] |
Bài đánh giá kèm thông tin vị trí. |
nextPageToken |
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 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 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 Tổng quan về OAuth 2.0.
LocationReview
Đại diện cho một bài đánh giá bằng thông tin vị trí.
Biểu diễn dưới dạng JSON | |
---|---|
{
"name": string,
"review": {
object ( |
Các trường | |
---|---|
name |
Tên tài nguyên vị trí. |
review |
Bài đánh giá về vị trí. |