תהליכי עבודה של API

במדריך הזה מוסבר על תהליכי עבודה נפוצים ב-API ליצירה, לאחזור ולעדכון של חבילות של מכרזים ב-Display & Video 360.

קבלת רשימה של חבילות למכירה פומבית

מתקשרים אל LIST API. תמיכה בסינון לפי external_deal_id.

יצירת חבילת מכרז חדשה

  1. הערך של external_deal_id חייב להיות ייחודי. מתקשרים לרשימה עם 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, ואי אפשר לעדכן את הסטטוס. חבילות מושהות אינן גלויות בממשק המשתמש של DV360. כך יכולות בורסות לבדוק שילוב API בלי להציג חבילות בדיקה.

מקובל ליצור את כל החבילות ה'אמיתיות' בגרסת הבטא במצב PAUSED (מושהה) ואז להפעיל אותן בגרסה הרגילה.

מכסה

‫2,000 חבילות פעילות לכל בורסה.

‫2,000 חבילות מושהות לכל בורסה.