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

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

طلبات

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

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

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

في ما يلي مقارنة بين Content API for Shopping وMerchant Email API للطلبات المتعلقة بالعروض الترويجية.

عنوان 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 for 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,
    ]
    }
  ]
}