العمل مع بيانات المراجعة

يوضّح لك هذا البرنامج التعليمي كيفية إدراج مراجعة وعرضها والردّ عليها وحذفها. تمنحك واجهة برمجة تطبيقات "نشاطي التجاري على 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 = reviewsList.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
}

الردّ على مراجعة

ملاحظة مهمة: لاستخدام هذه الوظيفة، عليك التأكّد من أنّ مشرف مؤسستك في G Suite قد فعّل "بحث Google" و/أو "خرائط Google" كخدمات لحسابك، بالإضافة إلى "الملف التجاري على Google". وإذا واجهتك أي مشاكل، يُرجى التواصل مع المشرف. لمزيد من المعلومات، اطّلِع على مقالة من هو مشرفي؟، التحكّم في المستخدمين الذين يمكنهم الوصول إلى خدمات Google وG Suite، وتطبيق السياسات على مستخدمين مختلفين.

يمكنك الردّ على مراجعة معيّنة أو إنشاء ردّ جديد إذا لم يكن هناك ردّ حالي. استخدِم واجهة برمجة التطبيقات 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  = reply.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;
}