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

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

קבלת רשימה של בעלי תוכן דיגיטלי

קוראים לפונקציה LIST API.

יצירת בעל אפליקציה חדש

  1. externalPublisherId הוא שדה חובה והוא חייב להיות ייחודי. אפשר לאכלס את externalPublisherIds במזהים של בעלי תוכן דיגיטלי נוספים.
  2. קוראים ל-Create API. יוקצה שם ייחודי, וניתן יהיה להשתמש בו כדי לקבל את המוציא לאור שנוצר.
  3. מפעילים את Get API כדי לראות את הפרטים של בעל האפליקציה שנוצר.
  4. אופציונלי, מעלים לוגו לבעל התוכן הדיגיטלי שנוצר.

עדכון של בעל תוכן דיגיטלי

  1. אם לא שמרתם את השם של בעל האפליקציה שנוצר, תוכלו להתקשר אל LIST API כדי למצוא את בעל האפליקציה שאתם רוצים לעדכן.
  2. מעדכנים את השדות על סמך התוצאות מ-LIST API.
  3. מתקשרים אל Patch API כדי לעדכן את בעל התוכן הדיגיטלי. השדה updateMask הוא שדה חובה. הוא מציין את השדות שרוצים להחיל עליהם את העדכון. אפשר להגדיר ב-updateMask רק שדות שאפשר לעדכן.

שדות חשובים שצריך לספק:

  • השם המוצג
  • תיאור
  • פרטים ליצירת קשר
  • לוגו
  • תחזית
    • ספק את DOMAIN_NAME שבבעלות המוציא לאור תחת 'פירוטים'
    • צריך לציין אפליקציה בבעלות בעל התוכן הדיגיטלי בקטע appsBreakdown