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

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

نظرة عامة على التغييرات من 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,
    ]
    }
  ]
}