العمل باستخدام بيانات المراجعات

يشرح لك هذا الدليل التوجيهي كيفية سرد مراجعة وإرجاعها والرد عليها وحذفها. تشير رسالة الأشكال البيانية تتيح لك واجهة برمجة تطبيقات "نشاطي التجاري على Google" العمل مع بيانات المراجعة من أجل إجراء العمليات التالية:

قبل البدء

قبل استخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google"، يجب تسجيل التطبيق والحصول على بيانات اعتماد OAuth 2.0. للحصول على تفاصيل حول كيفية البدء باستخدام Google My Business API، اطّلِع على الإعداد الأساسي:

إدراج جميع المراجعات

أدرِج جميع المراجعات عن موقع جغرافي معيّن لتدقيق المراجعات بشكل مجمّع. يمكنك استخدام accounts.locations.reviews.list API لعرض جميع المراجعات المرتبطة بموقع جغرافي.

لإرجاع جميع المراجعات المرتبطة بموقع جغرافي معيّن، استخدِم ما يلي:

بروتوكول HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews
Java

تستخدم الدالة التالية الدالة 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 واجهة برمجة التطبيقات لعرض مراجعة محددة مرتبطة بموقع جغرافي.

لإرجاع مراجعة محدّدة، استخدِم ما يلي:

بروتوكول HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}
Java

تستخدم الدالة التالية الدالة 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 إمكانية الوصول إلى بيانات حقول إضافية للمراجعة الحالات. استخدِم الطرق التالية لعرض بيانات إضافية عن المراجعات:

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

الحصول على مراجعات من مواقع جغرافية متعددة

الحصول على مراجعات من مواقع جغرافية متعددة يمكنك استخدام accounts.locations.batchGetReviews واجهة برمجة التطبيقات لعرض المراجعات من مواقع متعددة في طلب واحد.

لإرجاع مراجعات من مواقع جغرافية متعدّدة، استخدِم ما يلي:

بروتوكول 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 واجهة برمجة التطبيقات للردّ على مراجعة محدّدة مرتبطة بموقع جغرافي معيّن.

للردّ على مراجعة معيّنة، يمكنك استخدام ما يلي:

بروتوكول HTTP
PUT
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}/reply

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

تستخدم الدالة التالية الدالة 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 واجهة برمجة التطبيقات لحذف ردّ على مراجعة محدّدة مرتبطة بموقع جغرافي معيّن.

لحذف ردّ محدّد على مراجعة، يمكنك استخدام ما يلي:

بروتوكول HTTP
DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/reviews/{reviewId}/reply
Java

تستخدم الدالة التالية الدالة 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;
}