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

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

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

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

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

طريقة العمل

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

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

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

POST/{catalog_id}/items_batch

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

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

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

GET/{catalog_id}/check_batch_request_status

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

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

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

POST/{catalog_id}/localized_items_batch

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

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

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

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

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

معرفة المزيد