سير عمل واجهة برمجة التطبيقات

الحصول على قائمة بحِزم المزادات

استدعاء LIST API يتيح الفلترة حسب external_deal_id

إنشاء حزمة مزاد جديدة

  1. يجب أن يكون external_deal_id فريدًا. اتّصِل بالدالة LIST مع external_deal_id لمعرفة ما إذا كان قد تم استخدام المعرّف من قبل.
  2. اتّصِل بالدالة Create API. سيتم تعيين اسم فريد، ويمكن استخدامه للحصول على الحزمة التي تم إنشاؤها.
  3. استدعِ الدالة Get API للاطّلاع على تفاصيل "حزمة المزاد" التي تم إنشاؤها.
  4. يمكنك اختياريًا تحميل شعار للحزمة التي تم إنشاؤها.

تعديل حزمة المزاد

  1. إذا لم تخزِّن اسم "حزمة المزاد" التي تم إنشاؤها، استخدِم فلتر LIST API حسب external_deal_id للحصول على "حزمة المزاد" التي تريد تعديلها.
  2. عدِّل الحقول استنادًا إلى النتائج من LIST API.
  3. استدعِ Patch API لتعديل حزمة المزاد. يجب توفير "updateMask"، وهو يشير إلى الحقول التي تريد تطبيق التعديل عليها. لا يمكن ضبط سوى الحقول المسموح بتعديلها في updateMask.

عملية الإصدار التجريبي

الفرق الوحيد بين الإصدار التجريبي والإصدار المتاح للجميع هو أنّه خلال الإصدار التجريبي، يجب ضبط حالة "حِزم عروض الأسعار" التي تم إنشاؤها على DISCOVERY_OBJECT_STATUS_PAUSED، ولا يمكن تعديل الحالة. لا تظهر الحِزم التي تم إيقافها مؤقتًا في واجهة مستخدم "مساحة العرض والفيديو 360". يهدف ذلك إلى توفير طريقة لجهات التبادل لاختبار عملية دمج واجهة برمجة التطبيقات بدون عرض حِزم الاختبار.

من الشائع إنشاء جميع الحِزم "الحقيقية" في الإصدار التجريبي على أنّها PAUSED ثم "تفعيلها" بعد إتاحتها للجميع.

الحصة

‫2,000 حزمة نشطة لكلّ شبكة تبادل

‫2,000 حزمة متوقّفة مؤقتًا لكلّ شبكة تبادل