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

يمكنك استخدام Merchant Promotions API لإنشاء العروض الترويجية وإدارتها على Google. يتيح لك المرجع accounts.promotions عرض عروض خاصة للمنتجات التي تبيعها على Google. لمزيد من المعلومات، اطّلِع على نظرة عامة على Merchant Promotions 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/v1beta/{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/v1beta/{parent=accounts/*}/promotions

المعرفات

في Content API for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

في Merchant API، تصبح:

{NAME}

الطُرق

تتيح Merchant API الطرق التالية للعروض الترويجية:

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

في ما يلي مقارنة بمدى توفّر طرق العروض الترويجية في Content API for Shopping وMerchant API:

الميزة واجهة برمجة تطبيقات المحتوى في Shopping Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
المعرّفات {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
الطُرق
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list
  • delete

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

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

للاطّلاع على مثال مرجعي، يُرجى الاطّلاع على المنتجات المتوفّرة داخل المتجر.

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