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

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

الطلبات

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

الميزة Content API for 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 Promotions API.

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

Content API for Shopping Merchant API الوصف
(غير مدعم) custom_attributes قائمة بالسمات المخصّصة (التي يقدّمها المستخدم). يمكنك
أيضًا استخدامها لإرسال أي سمة من مواصفات الخلاصة
في شكلها العام.
على سبيل المثال: 
{
  "name": "size type", "value": "regular"
}
يكون ذلك مفيدًا لإرسال السمات التي لا
تعرضها واجهة برمجة التطبيقات بشكل صريح.
غير متاح data_source يتطلّب إنشاء عرض ترويجي مصدر بيانات حاليًا.
غير متاح attributes تُعدّ السمات الخاصة بالعرض الترويجي، مثل
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.

تم تغيير اسم حقل العملة إلى
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,
    ]
    }
  ]
}