يمكنك استخدام واجهة برمجة التطبيقات "الرسائل الترويجية للتاجر" لإنشاء العروض الترويجية وإدارتها على 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 من القيمة إلى
تم تغيير اسم الحقل currency إلى
|
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, ] } ] } |