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

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

الميزة 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

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

يعرض الجدول التغييرات التي تطرأ على الرسائل الترويجية للتاجر في Merchant Promotions API.

للاطّلاع على مثال كمرجع، يُرجى الاطّلاع على accounts.promotions.

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، كان السعر
عددًا عشريًا في شكل سلسلة.

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

تم تغيير اسم الحقل amount من value إلى
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,
    ]
    }
  ]
}
السابق
Migrate order tracking signals
التالي
Migrate conversion sources management