Làm việc với dữ liệu bài đánh giá

Hướng dẫn này sẽ chỉ cho bạn cách đăng, trả lại, trả lời và xoá bài đánh giá. API Google Doanh nghiệp của tôi cho phép bạn xử lý dữ liệu bài đánh giá để thực hiện các thao tác sau:

Trước khi bắt đầu

Trước khi sử dụng API Google Doanh nghiệp của tôi, bạn cần đăng ký ứng dụng và lấy thông tin xác thực OAuth 2.0. Để biết thông tin chi tiết về cách bắt đầu sử dụng API Google Doanh nghiệp của tôi, hãy xem phần Thiết lập cơ bản.

Liệt kê tất cả bài đánh giá

Liệt kê tất cả bài đánh giá về một địa điểm để kiểm tra hàng loạt bài đánh giá. Sử dụng API accounts.locations.reviews.list để trả về tất cả bài đánh giá được liên kết với một địa điểm.

Để trả về tất cả bài đánh giá liên kết với một vị trí, hãy sử dụng đoạn mã sau:

HTTPJava
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews

Hàm sau đây sử dụng Mybusiness.Accounts.Locations.Reviews.List.

/**
 * Returns a list of reviews.
 * @param locationName Name of the location to retrieve reviews for.
 * @return List<Reviews> A list of reviews.
 * @throws Exception
 */
public static List<Review> listReviews(String locationName) throws Exception {
  Mybusiness.Accounts.Locations.Reviews.List reviewsList =
    mybusiness.accounts().locations().reviews().list(locationName);
  ListReviewsResponse response = accountsList.execute();
  List<Reviews> reviews = response.getReviews();

  for (Reviews review : reviews) {
    System.out.println(review.toPrettyString());
  }
  return reviews;
}

Xem một bài đánh giá cụ thể

Trả về một bài đánh giá cụ thể theo tên. Sử dụng API accounts.locations.reviews.get để trả về một bài đánh giá cụ thể liên kết với một vị trí.

Để trả về một bài đánh giá cụ thể, hãy sử dụng đoạn mã sau:

HTTPJava
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}

Hàm sau đây sử dụng Mybusiness.Accounts.Locations.Reviews.Get.

/**
 * Demonstrates getting a review by name.
 * @param reviewName The name (resource path) of the review to retrieve.
 * @return Account The requested review.
 */
private static Review getReview(String reviewName) throws Exception {
  Mybusiness.Accounts.Locations.Reviews.Get review =
      mybusiness.accounts().locations().reviews().get(reviewName);
  Review response = review.execute();

  return response;
}

Dữ liệu bổ sung

Thư viện ứng dụng Java cho phép bạn truy cập vào dữ liệu trường bổ sung cho các bản xem xét. Hãy sử dụng các phương thức sau để trả về dữ liệu bổ sung về bài đánh giá:

  • getReviewId()
  • getComment()
  • getReviewer()
  • getStarRating()
  • getCreateTime()
  • getReviewReply()

Nhận bài đánh giá từ nhiều vị trí

Nhận bài đánh giá từ nhiều vị trí. Sử dụng API accounts.locations.batchGetReviews để trả về bài đánh giá từ nhiều vị trí trong một yêu cầu.

Để trả về bài đánh giá từ nhiều địa điểm, hãy sử dụng các thông tin sau:

HTTP

POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations:batchGetReviews

{
  "locationNames": [
    string
  ],
  "pageSize": number,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}

Trả lời bài đánh giá

Trả lời một bài đánh giá cụ thể hoặc tạo một bài trả lời mới nếu chưa có. Sử dụng API accounts.locations.reviews.updateReply để trả lời một bài đánh giá cụ thể liên kết với một vị trí.

Để trả lời một bài đánh giá cụ thể, hãy làm như sau:

HTTPJava
PUT
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}/reply

{
  comment: "Thank you for visiting our business!"
}

Hàm sau đây sử dụng Mybusiness.accounts.locations.reviews.reply.

/*
 * Updates the reply for a location review.
 * If a review does not exist, creates a new one.
 * @param reviewName Name of the review being responded to.
 * @param comment A string containing the review response body.
 * @throws IOException
 */
private static Reply reply(String reviewName, String comment) throws IOException {

  MyBusiness.Accounts.Locations.Reviews.Reply reply =
    mybusiness().accounts().locations().reviews().reply(reviewName, comment);

  Reply response  = reviewReply.execute();

  return response;
}

Xoá câu trả lời cho bài đánh giá

Xoá câu trả lời cho một bài đánh giá cụ thể. Sử dụng API accounts.locations.reviews.deleteReply để xoá một câu trả lời cho một bài đánh giá cụ thể được liên kết với một địa điểm.

Để xoá một câu trả lời cụ thể cho một bài đánh giá, hãy làm như sau:

HTTPJava
DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}/reply

Hàm sau đây sử dụng Mybusiness.Accounts.Locations.Reviews.DeleteReply.

/**
 * Demonstrates deleting a review reply by name.
 * @param reviewName The name (resource path) of the review reply to delete.
 * @return Account The requested review.
 */
private static DeleteReply deleteReply(String reviewName) throws Exception {
  Mybusiness.Accounts.Locations.Reviews.DeleteReply toDelete =
      mybusiness.accounts().locations().reviews().deleteReply(reviewName);
  DeleteReply response = toDelete.execute();

  return response;
}