‏كتالوج المنتجات‏

API دفعة الكتالوج

يتناول هذا الدليل طريقة استخدام API دفعة الكتالوج:

  • بالنسبة إلى كتالوجات إعلانات كتالوج Advantage+ — استخدم API هذه إذا كانت لديك كتالوجات كبيرة مثل كتالوج يحتوي على ملايين العناصر ذات المخزون سريع التغيّر. يمكنك إنشاء عناصر متعددة وتحديثها وحذفها في طلب HTTP واحد.

  • بالنسبة لكتالوجات التجارة — استخدم API هذه إذا كنت تريد تحديث معلومات المنتج لأكثر من مرة في الساعة (بخلاف ذلك، استخدم API قائمة البيانات). يمكنك تحديث عناصر متعددة في طلب HTTP واحد.

طريقة العمل

استخدم واجهة API دفعة الكتالوج إذا كانت لديك كتالوجات كبيرة مثل كتالوج يحتوي على ملايين العناصر ذات المخزون سريع التغيّر. يمكنك إنشاء عناصر متعددة وتحديثها وحذفها في طلب HTTP واحد.

تتكون واجهة API دفعة الكتالوج من نقاط النهاية التالية:

نقطة النهاية الوصف في هذا الدليل

POST/{catalog_id}/items_batch

يمكن إرسال دفعة طلبات (إنشاء وتحديث وحذف) لكتالوج منتجات. ويُستخدم في عدة كائنات مختلفة مثل المنتجات والفنادق وغرف الفنادق والرحلات الجوية والوجهات وقوائم المعروضات المنزلية والمركبات وعروض المركبات.

يدعم جميع إصدارات MAPI حتى الإصدار 3.2.

إرسال تحديثات بشأن المنتجات

GET/{catalog_id}/check_batch_request_status

يمكن التحقق من حالة طلب الدفعة. استخدم اسم المستخدم (الذي يتم إرجاعه من استدعاء {catalog_id}/batch) وقم بإجراء استدعاء GET.

يدعم جميع إصدارات MAPI السابقة للإصدار 3.1.

التحقق من حالة الطلبات المجمّعة

POST/{catalog_id}/localized_items_batch

يمكن إرسال طلبات التطويع المحلي للدُفعة إلى عناصر الكتالوج الموجودة في الكتالوج لديك. يمكن أن تحتوي الدُفعة على طلبات التطويع المحلي (إنشاء وتحديث وحذف). ويمكن استخدام نقطة النهاية هذه ضمن مجموعة من الكائنات المختلفة، مثل المنتجات والفنادق والرحلات الجوية والوجهات وقوائم المعروضات المنزلية والمركبات.

يدعم جميع إصدارات MAPI، قبل الإصدار 3.1.

إرسال دُفعة عناصر مُطوّعة محليًا

الخطوات التالية

استخدم دلائل API دفعة الكتالوج لمساعدتك في تنفيذ الإجراءات الشائعة باستخدام API دفعة الكتالوج.

معرفة المزيد