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

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

الطلبات

لتقديم طلبات، استخدِم عنوان URL التالي.

POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions

نقل البيانات من Content API for Shopping

في ما يلي مقارنة بين Content API for Shopping و"الرسائل الترويجية للتاجر" واجهة برمجة تطبيقات للطلبات المتعلّقة بالعروض الترويجية

عنوان URL

في Content API for Shopping:

https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions

في Merchant API:

https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

المعرفات

في Content API for Shopping:

{merchantId}/promotions/{promotionId}

في Merchant API:

{name}

الطُرق

تتيح واجهة Merchant API استخدام الطرق التالية للعروض الترويجية:

  • إدراج الإعلانات الترويجية
  • الحصول على عروض ترويجية
  • إدراج العروض الترويجية

في ما يلي مقارنة بين مدى توفّر طُرق الترويج في Content API للحساب Shopping وMerchant API:

الطريقة واجهة برمجة تطبيقات المحتوى في Shopping واجهة برمجة تطبيقات التاجر
إدراج نعم نعم
الحصول على نعم نعم
list نعم نعم
customBatch لا لا
حذف لا (يُحدَّد لاحقًا)

اسم المورد

يعرض الجدول التغييرات التي تطرأ على "العروض الترويجية" في واجهة برمجة تطبيقات "الرسائل الترويجية للتاجر".

لعرض مثال للرجوع إليه، يُرجى مراجعة دليل محلي المستودع الإعلاني:

واجهة برمجة تطبيقات المحتوى في Shopping واجهة برمجة تطبيقات التاجر الوصف
(غير مدعم) custom_attributes قائمة بالسمات المخصّصة (المقدّمة من التاجر). يمكنك
يمكنك أيضًا استخدامه لإرسال أي سمة للخلاصة
والمواصفات في شكلها العام.
مثل: 
{
  "name": "size type", "value": "regular"
}
يفيد ذلك في إرسال السمات غير الواضحة
الكشف عنها من خلال واجهة برمجة التطبيقات.
غير متاح data_source يتطلّب إنشاء عرض ترويجي مصدر بيانات حالي.
غير متاح السمات السمات الخاصة بالعرض الترويجي، مثل
long_tile وlong_tile,
والبعض الآخر جزءًا من رسالة السمة.
item_id item_id_inclusion قائمة معرّفات السلع التي ينطبق عليها العرض الترويجي تمت إعادة تسمية
إلى.
store_id store_id_inclusion قائمة بمعرّفات المتاجر التي ينطبق عليها العرض الترويجي
تمت إعادة تسميته إلى.
prduct_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 من قيمة إلى
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,
    ]
    }
  ]
}