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

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

قبل البدء

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

عرض جميع المراجعات

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

لعرض جميع المراجعات المرتبطة بموقع جغرافي، يُرجى استخدام ما يلي:

بروتوكول 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;
}