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

يمكنك استخدام Merchant Promotions API لإنشاء الرسائل الترويجية للتاجر وإدارتها على Google. يتيح لك المورد accounts.promotions عرض عروض خاصة للمنتجات التي تبيعها على Google. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على Merchant Promotions 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,
    ]
    }
  ]
}