إدارة العروض الترويجية

يمكنك استخدام Merchant Promotions API لإنشاء الرسائل الترويجية للتاجر وإدارتها على Google. يتيح لك مرجع accounts.promotions عرض عروض خاصة للمنتجات التي تبيعها على Google. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على الرسائل الترويجية للتاجر API.

نظرة عامة على التغييرات من Content API for Shopping إلى Merchant API

أحد الاختلافات المهمة هو أنّ Content API for Shopping ينشئ مصدر البيانات تلقائيًا عند إدراج أول عرض ترويجي، بينما لا يحدث ذلك في Merchant API. لإدراج عرض ترويجي باستخدام Merchant API، عليك أولاً أن تنشئ مصدر بيانات للعروض الترويجية.

للحصول على معلومات حول الحقول في عنصر promotionDataSource في accounts.dataSources مرجع، يُرجى الاطّلاع على PromotionDataSource.

مصادر البيانات الحالية

بالنسبة إلى مصادر البيانات الحالية، إذا لم يكُن لديك accounts.dataSources.name، استخدِم dataSources.list لاسترداده.

بدلاً من ذلك، يمكنك تحديد مصدر البيانات لكل عرض من عروضك الترويجية باستخدام طريقة accounts.promotions.get والاطّلاع على حقل dataSource في ردّ أي عروض ترويجية حالية ضمن حسابك.

للإشارة إليها مباشرةً في طلبات بيانات من واجهة برمجة التطبيقات المستقبلية، ننصحك بشدة بتخزين accounts.dataSources.name في قاعدة بياناتك المحلية لكل عرض ترويجي.

الطلبات

لتقديم الطلبات، استخدِم عنوان URL التالي.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

نقل البيانات من Content API for Shopping

في ما يلي مقارنة بين Content API for Shopping وMerchant Promotions API للطلبات المتعلقة بالعروض الترويجية.

عنوان URL

في Content API for Shopping:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

في Merchant API، يصبح عنوان URL:

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

المعرّفات

في Content API for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

في Merchant API، يصبح عنوان URL:

{NAME}

الطُرق

تتيح Merchant API الطرق التالية للعروض الترويجية:

• إدراج العروض الترويجية
• الحصول على العروض الترويجية
• عرض قائمة العروض الترويجية

في ما يلي مقارنة بين مدى توفّر طرق العروض الترويجية في Content API for Shopping وMerchant API:

تغييرات الحقول

يعرض الجدول التغييرات التي تطرأ على الرسائل الترويجية للتاجر في Merchant Promotions API.

للاطّلاع على مثال كمرجع، يُرجى الاطّلاع على accounts.promotions.

{
  "name": "size type", "value": "regular"
}

price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }

{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}

promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}