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

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

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

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