با داده های بررسی کار کنید

این آموزش به شما نشان می دهد که چگونه یک نظر را فهرست کنید، بازگردانید، پاسخ دهید و حذف کنید. Google My Business API این امکان را برای شما فراهم می‌کند که با داده‌های مرور کار کنید تا عملیات زیر را انجام دهید:

قبل از شروع

قبل از استفاده از Google My Business API، باید برنامه خود را ثبت کنید و اعتبارنامه OAuth 2.0 را دریافت کنید. برای جزئیات در مورد نحوه شروع به کار با Google My Business API، به تنظیمات اولیه مراجعه کنید.

فهرست همه نظرات

فهرست همه مرورهای یک مکان برای بازرسی نظرات به صورت انبوه. از accounts.locations.reviews.list API برای برگرداندن همه بررسی های مرتبط با یک مکان استفاده کنید.

برای بازگرداندن همه نظرات مرتبط با یک مکان، از موارد زیر استفاده کنید:

HTTP 
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews
جاوا

تابع زیر از 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;
}

یک بررسی خاص دریافت کنید

یک بررسی خاص را با نام برگردانید. از accounts.locations.reviews.get API برای بازگرداندن یک بررسی خاص مرتبط با یک مکان استفاده کنید.

برای بازگرداندن یک بررسی خاص، از موارد زیر استفاده کنید:

HTTP 
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}
جاوا

تابع زیر از 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;
}

داده های اضافی

کتابخانه Java Client به شما امکان دسترسی به داده های میدانی اضافی را برای نمونه های بازبینی می دهد. از روش‌های زیر برای بازگرداندن اطلاعات اضافی درباره نظرات استفاده کنید:

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

نظرات را از چندین مکان دریافت کنید

نظرات را از چندین مکان دریافت کنید. از accounts.locations.batchGetReviews API برای بازگرداندن نظرات از چندین مکان در یک درخواست استفاده کنید.

برای بازگرداندن نظرات از چندین مکان، از موارد زیر استفاده کنید:

HTTP 

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

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

به یک بررسی پاسخ دهید

به یک بررسی خاص پاسخ دهید، یا در صورت عدم وجود پاسخ جدیدی ایجاد کنید. از accounts.locations.reviews.updateReply API برای پاسخ به یک بررسی خاص مرتبط با یک مکان استفاده کنید.

برای پاسخ به یک بررسی خاص، از موارد زیر استفاده کنید:

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

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

تابع زیر از 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;
}

پاسخ بررسی را حذف کنید

پاسخ به یک بررسی خاص را حذف کنید. از accounts.locations.reviews.deleteReply API برای حذف پاسخ به یک بررسی خاص مرتبط با یک مکان استفاده کنید.

برای حذف یک پاسخ خاص به یک بررسی، از موارد زیر استفاده کنید:

HTTP 
DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}/reply
جاوا

تابع زیر از 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;
}