مراجعة المنتجات باستخدام Merchant API

تشكّل مراجعات المنتجات جزءًا مهمًا من تجربة التسوّق للعملاء. تساعد هذه التقييمات والمراجعات العملاء في اتخاذ قرارات البحث عن المنتجات وشرائها. يمكن أن تجذب المراجعات الإيجابية حول المنتجات المزيد من العميل ين المؤهّلين إلى صفحات منتجات البائع. وتشمل المصادر البائعين وخدمات جمع المراجعات ومواقع المراجعات ومستخدمي Google.

توضّح هذه الصفحة كيفية إدارة مراجعات المنتجات باستخدام Merchant API.

المتطلبات الأساسية

تطلب منك Google تقديم معلومات محدّدة. يجب توفّر ما يلي:

• خلاصة نشطة لمراجعات المنتجات في Google Merchant Center
• يجب أن يكون حسابك مسجّلاً في برنامج "تقييمات المنتج". إذا كنت غير متأكّد من أنّك مسجّل في البرنامج، يُرجى التحقّق من ذلك في Merchant Center. إذا لم تكن مسجّلاً في البرنامج، يمكنك الاطّلاع على مزيد من المعلومات حول التسجيل في برنامج تقييمات المنتجات.
• لمراجعة المنتجات باستخدام Merchant API، أرسِل طلبًا باستخدام هذا النموذج.

ملاحظة: خلاصة مراجعات المنتجات ليست هي نفسها خلاصة المنتجات.

إنشاء مصدر بيانات

استخدِم واجهة برمجة التطبيقات datasource.create لإنشاء خلاصة مراجعات المنتجات. إذا كانت هناك خلاصة حالية لمراجعات المنتجات، استخدِم accounts.dataSources.get لجلب accounts.dataSources.name. في ما يلي نموذج الطلب:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{account}/dataSources/{datasource}

مثال

يعرض المثال طلبًا واستجابةً نموذجيَين.

الطلب

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "productReviewDataSource":{} }

الاستجابة

{
  "name": "accounts/123/dataSources/1000000573361824",
  "dataSourceId": "1000000573361824",
  "displayName": "test api feed",
  "productReviewDataSource": {},
  "input": "API"
}

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على Merchant Data API.

إنشاء مراجعة منتج

يمكنك استخدام الطريقة accounts.productreviews.insert لإنشاء أو تعديل مراجعة منتج. تأخذ طريقة accounts.productreviews.insert مَعلمة موارد productreview واسم مصدر بيانات كمدخلات. ويعرض الإجراء productreview الجديد أو المعدَّل، في حال نجاحه. لإنشاء مراجعة منتج، يجب امتلاك datasource.name.

ملاحظة مهمة: يؤدي هذا الطلب إلى استبدال مصدر مراجعات المنتجات بالكامل، لذا يجب أن يتضمّن طلب الإزالة جميع التفاصيل لتجنّب فقدان المعلومات.

نموذج الطلب:

POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/{ACCOUNT_ID}/}productReviews:insert

يوضّح نموذج الطلب التالي كيفية إنشاء مراجعة منتج.

POST https://merchantapi.googleapis.com/reviews/v1beta/accounts/{ACCOUNT_ID}/productReviews:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}

  productReviewId = 'my_product_review'
  attributes {
    aggregatorName = 'aggregator_name'
    subclientName = 'subclient_name'
    publisherName = 'publisher_name'
    publisherFavicon = 'https://www.google.com/favicon.ico'
    reviewerId = 'reviewer_id'
    reviewerIsAnonymous = false
    reviewerUsername = 'reviewer_username'
    reviewLanguage = 'en'
    reviewCountry = 'US'
    reviewTime = '2024-04-01T00:00:00Z'
    title = 'Incredible product'
    content = 'This is an incredible product.'
    pros = ['pro1', 'pro2']
    cons = ['con1', 'con2']
    reviewLink = {
      type = 'SINGLETON'
      link = 'https://www.google.com'
    }
    reviewerImageLink = 'https://www.google.com/reviewer.png'
    minRating = 1
    maxRating = 10
    rating = 8.5
    productName = 'product_name'
    productLink = 'https://www.google.com/product'
    asins = ['asin1', 'asin2']
    gtins = ['gtin1', 'gtin2']
    mpns = ['mpn1', 'mpn2']
    skus = ['sku1', 'sku2']
    brands = ['brand1', 'brand2']
    isSpam = false
    collectionMethod = 'POST_FULFILLMENT'
    transactionId = 'transaction_id'
  }

بعد إنشاء مراجعة المنتج، قد يستغرق الأمر بضع دقائق لكي تتم نشر المراجعة.

في ما يلي نموذج يمكنك استخدامه لإدراج مراجعات منتجات متعددة بشكل غير متزامن:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.reviews.v1beta.ListProductReviewsRequest;
import com.google.shopping.merchant.reviews.v1beta.ProductReview;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient.ListProductReviewsPagedResponse;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to list all the product reviews in a given account. */
public class ListProductReviewsSample {

  public static void listProductReviews(String accountId) throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    ProductReviewsServiceSettings productReviewsServiceSettings =
        ProductReviewsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (ProductReviewsServiceClient productReviewsServiceClient =
        ProductReviewsServiceClient.create(productReviewsServiceSettings)) {

      ListProductReviewsRequest request =
          ListProductReviewsRequest.newBuilder()
              .setParent(String.format("accounts/%s", accountId))
              .build();

      System.out.println("Sending list product reviews request:");
      ListProductReviewsPagedResponse response =
          productReviewsServiceClient.listProductReviews(request);

      int count = 0;

      // Iterates over all rows in all pages and prints all product reviews.
      for (ProductReview element : response.iterateAll()) {
        System.out.println(element);
        count++;
      }
      System.out.print("The following count of elements were returned: ");
      System.out.println(count);
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    listProductReviews(config.getAccountId().toString());
  }
}
ListProductReviewsSample.java

استرداد مراجعة منتج

للاطّلاع على مراجعة منتج، استخدِم accounts.productreviews.get. هذا القسم للقراءة فقط. وتتطلّب هذه السمة إدخال accountId ورقم تعريف مراجعة المنتج كجزء من حقل name. تُعرِض الطريقة GET مرجع مراجعة المنتج المقابل.

GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/{ACCOUNT_ID}/productReviews/*}

في ما يلي نموذج يمكنك استخدامه لاسترداد مراجعة منتج:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.reviews.v1beta.GetProductReviewRequest;
import com.google.shopping.merchant.reviews.v1beta.ProductReview;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to get a product review. */
public class GetProductReviewSample {

  public static void getProductReview(String accountId, String productReviewId) throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    ProductReviewsServiceSettings productReviewsServiceSettings =
        ProductReviewsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (ProductReviewsServiceClient productReviewsServiceClient =
        ProductReviewsServiceClient.create(productReviewsServiceSettings)) {

      GetProductReviewRequest request =
          GetProductReviewRequest.newBuilder()
              .setName(String.format("accounts/%s/productReviews/%s", accountId, productReviewId))
              .build();

      System.out.println("Sending get product review request:");
      ProductReview response = productReviewsServiceClient.getProductReview(request);
      System.out.println("Product review retrieved successfully:");
      System.out.println(response.getName());
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    String productReviewId = "YOUR_PRODUCT_REVIEW_ID";
    getProductReview(config.getAccountId().toString(), productReviewId);
  }
}
GetProductReviewSample.java

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

يمكنك استخدام الطريقة productreviews.list للاطّلاع على كل مراجعات المنتجات التي تم إنشاؤها.

GET https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/{ACCOUNT_ID}}/productReviews

في ما يلي نموذج يمكنك استخدامه لعرض كل المراجعات لمنتج معيّن:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.reviews.v1beta.ListProductReviewsRequest;
import com.google.shopping.merchant.reviews.v1beta.ProductReview;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient.ListProductReviewsPagedResponse;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to list all the product reviews in a given account. */
public class ListProductReviewsSample {

  public static void listProductReviews(String accountId) throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    ProductReviewsServiceSettings productReviewsServiceSettings =
        ProductReviewsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (ProductReviewsServiceClient productReviewsServiceClient =
        ProductReviewsServiceClient.create(productReviewsServiceSettings)) {

      ListProductReviewsRequest request =
          ListProductReviewsRequest.newBuilder()
              .setParent(String.format("accounts/%s", accountId))
              .build();

      System.out.println("Sending list product reviews request:");
      ListProductReviewsPagedResponse response =
          productReviewsServiceClient.listProductReviews(request);

      int count = 0;

      // Iterates over all rows in all pages and prints all product reviews.
      for (ProductReview element : response.iterateAll()) {
        System.out.println(element);
        count++;
      }
      System.out.print("The following count of elements were returned: ");
      System.out.println(count);
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    listProductReviews(config.getAccountId().toString());
  }
}
ListProductReviewsSample.java

حذف مراجعات المنتجات

لحذف مراجعة منتج، استخدِم الرمز accounts.productreviews.delete. على غرار الطريقة GET، تتطلّب هذه الطريقة أن يتم عرض حقل الاسم الخاص بمراجعة المنتج أثناء الإنشاء.

DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/{ACCOUNT_ID}/productReviews/*}

في ما يلي نموذج يمكنك استخدامه لحذف مراجعة منتج:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.reviews.v1beta.DeleteProductReviewRequest;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceClient;
import com.google.shopping.merchant.reviews.v1beta.ProductReviewsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to delete a product review. */
public class DeleteProductReviewSample {

  public static void deleteProductReview(String accountId, String productReviewId)
      throws Exception {
    GoogleCredentials credential = new Authenticator().authenticate();

    ProductReviewsServiceSettings productReviewsServiceSettings =
        ProductReviewsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    try (ProductReviewsServiceClient productReviewsServiceClient =
        ProductReviewsServiceClient.create(productReviewsServiceSettings)) {

      DeleteProductReviewRequest request =
          DeleteProductReviewRequest.newBuilder()
              .setName(String.format("accounts/%s/productReviews/%s", accountId, productReviewId))
              .build();

      System.out.println("Sending delete product review request:");
      productReviewsServiceClient.deleteProductReview(request);
      System.out.println("Product review deleted successfully");
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    String productReviewId = "YOUR_PRODUCT_REVIEW_ID";
    deleteProductReview(config.getAccountId().toString(), productReviewId);
  }
}
DeleteProductReviewSample.java

حالة مراجعة المنتج

يحتوي مرجع مراجعة المنتج على حالة مشابهة لواجهات برمجة التطبيقات الأخرى، وهي جزء لا يتجزأ من المرجع وتتّبع بنية المشكلة والوجهة نفسها.