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

يمكنك استخدام 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.

الطلبات

لتقديم طلبات، استخدِم عنوان 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:

الميزة واجهة برمجة تطبيقات المحتوى في Shopping Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
المعرّفات {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
الطُرق
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list
  • delete

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

يوضّح الجدول التغييرات التي تم إجراؤها على واجهة برمجة التطبيقات الخاصة بالعروض الترويجية في Merchant Center.

للاطّلاع على مثال يمكنك الرجوع إليه، يُرجى الاطّلاع على المستودع المحلي.

واجهة برمجة تطبيقات المحتوى في Shopping Merchant API الوصف
(غير مدعم) custom_attributes قائمة بالسمات المخصّصة (التي يقدّمها المستخدم) يمكنك أيضًا استخدامها لإرسال أي سمة من مواصفات الخلاصة في شكلها العام.


مثال: 
{
  "name": "size type", "value": "regular"
}
يفيد ذلك في إرسال سمات لا تعرضها واجهة برمجة التطبيقات بشكل صريح
.
غير متاح data_source يتطلّب إنشاء عرض ترويجي توفّر مصدر بيانات حالي.
غير متاح السمات السمات الخاصة بالعروض الترويجية، مثل
long_tile وpromotion_effective_timeperiod
وغيرها، هي جزء من رسالة السمة.
item_id item_id_inclusion تمت إعادة تسمية قائمة أرقام تعريف السلع التي ينطبق عليها عرض ترويجي.
store_id store_id_inclusion تمت إعادة تسمية قائمة أرقام تعريف المتاجر التي يسري عليها العرض الترويجي
.
product_type product_type_inclusion تمت إعادة تسمية قائمة أنواع المنتجات التي ينطبق عليها عرض ترويجي
معيّن.
item_group_id item_group_id_inclusion تمت إعادة تسمية قائمة أرقام تعريف مجموعات السلع التي ينطبق عليها عرض ترويجي.
brand brand_inclusion تمت إعادة تسمية قائمة العلامات التجارية التي ينطبق عليها عرض ترويجي
معيّن.
store_code store_codes_inclusion تمت إعادة تسمية قائمة رموز المتاجر التي يسري عليها عرض ترويجي.
 
price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }
تم تغيير تعريف السعر.

في Content API for Shopping، كان السعر
عبارة عن رقم عشري في شكل سلسلة.

يتم الآن تسجيل مبلغ السعر بوحدات ميكرو،
حيث أنّ مليون وحدة ميكرو تعادل الوحدة العادية
من عملتك.

تم تغيير اسم الحقل المبلغ من القيمة إلى
amountMicros.

تم تغيير اسم الحقل currency إلى
currencyCode. يبقى التنسيق كما هو
ISO 4217. (ويكيبيديا)

order_limit (غير مدعم) السمة order_limit غير متاحة.
shippingServiceNames[] (غير مدعم) لا تتوفّر السمة shippingServiceNames[].
money_budget (غير مدعم) لا تتوفّر السمة money_budget.
promotion_destination_ids promotion_destinations تمت إعادة تسمية promotionDestinationIds.
حالة العرض الترويجي 
{
  "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,
    ]
    }
  ]
}