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

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

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

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

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

• خلاصة نشطة لمراجعات المنتجات في Google Merchant Center
• يجب أن يكون حسابك مسجّلاً في برنامج تقييمات المنتج. يمكنك التحقّق من الأهلية بشكل آلي باستخدام واجهة برمجة التطبيقات الفرعية "البرامج" أو من خلال Merchant Center.إذا لم تكن مؤهّلاً، يمكنك الاطّلاع على مزيد من المعلومات حول التسجيل في برنامج تقييمات المنتج.
• لمراجعة المنتجات باستخدام Merchant API، أرسِل طلب قائمة السماح في الـ نموذج دعم Shopping 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"
}

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء مصدر بيانات لمراجعات المنتجات.

**ملاحظة:** يصبح مصدر البيانات متاحًا فور إنشائه، لذا ليس عليك الانتظار إلى حين اكتمال أي عملية معالجة.

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

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

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

يكون شكل الطلب على النحو التالي:

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

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

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

  productReviewId = 'my_product_review'
  productReviewAttributes {
    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'
  }

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

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

جافا

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 ومعرّف مراجعة المنتج كجزء من حقل الاسم. تعرض طريقة GET مورد مراجعة المنتج المقابل.

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

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

جافا

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/v1/{parent=accounts/{ACCOUNT_ID}}/productReviews

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

جافا

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/v1/{name=accounts/{ACCOUNT_ID}/productReviews/*}

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

جافا

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

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

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