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

يمكنك استخدام 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، يصبح:

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

المعرّفات

في Content API for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

في Merchant API، يصبح:

{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,
    ]
    }
  ]
}