مراجعة المنتجات باستخدام 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'
  }

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

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

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

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

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

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

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

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

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

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

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

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