این راهنما، گردشهای کاری رایج API برای ایجاد، بازیابی و بهروزرسانی بستههای حراج در Display & Video 360 را شرح میدهد.
دریافت لیست بستههای حراجی
فراخوانی API مربوط به LIST . از فیلتر کردن بر اساس external_deal_id پشتیبانی میکند.
ایجاد بسته حراجی جدید
-
external_deal_idباید منحصر به فرد باشد. برای بررسی اینکه آیا شناسه قبلاً استفاده شده است یا خیر، LIST را باexternal_deal_idفراخوانی کنید. - API مربوط به Create را فراخوانی کنید. یک نام منحصر به فرد به آن اختصاص داده میشود و میتوان از آن برای دریافت بستهی ایجاد شده استفاده کرد.
- برای مشاهده جزئیات بسته حراج ایجاد شده، Get API را فراخوانی کنید.
- در صورت تمایل، یک لوگو برای بسته ایجاد شده آپلود کنید .
بسته حراج را بهروزرسانی کنید
- اگر نام بسته حراج ایجاد شده را ذخیره نمیکنید، برای دریافت بسته حراجی که میخواهید بهروزرسانی کنید، از API مربوط به LIST که توسط
external_deal_idفیلتر شده است، استفاده کنید. - فیلدها را بر اساس نتایج حاصل از API مربوط به LIST بهروزرسانی کنید.
- برای بهروزرسانی بستهی حراج، رابط برنامهنویسی کاربردی (API) پچ را فراخوانی کنید.
updateMaskالزامی است. این نشان میدهد که میخواهید بهروزرسانی روی کدام فیلدها اعمال شود. فقط فیلدهایی که مجاز به بهروزرسانی هستند را میتوان درupdateMaskتنظیم کرد.
فرآیند بتا
تنها تفاوت بین نسخه بتا و GA این است که در طول بتا، بستههای حراج ایجاد شده باید وضعیت DISCOVERY_OBJECT_STATUS_PAUSED داشته باشند و وضعیت قابل بهروزرسانی نیست. بستههای PAUSED در رابط کاربری DV360 قابل مشاهده نیستند. این امر به صرافیها راهی برای آزمایش ادغام API بدون نمایش بستههای آزمایشی میدهد.
رایج است که تمام بستههای «واقعی» در نسخه بتا به صورت «مکث» ایجاد شوند و سپس یک بار در GA فعال شوند.
سهمیه
۲۰۰۰ بسته فعال در هر مرکز مبادله.
۲۰۰۰ بسته در هر تبادل متوقف شد.