DV360 Out of Home Seller API

DV360 Out of Home Seller API מאפשר לנהל מלאי שטחי פרסום, הזמנות, לקבל נכסי קריאייטיב ולשלוח אירועים של הפעלת מודעות.

שירות: dv360outofhomeseller.googleapis.com

כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי לקרוא לשירות הזה, תוכלו להשתמש בפרטים הבאים כשתשלחו את בקשות ה-API.

מסמך Discovery

מסמך Discovery הוא מפרט קריא למחשבים שמיועד לתיאור ולשימוש בממשקי API ל-REST. הוא משמש לבניית ספריות לקוח, יישומי פלאגין ל-IDE וכלים אחרים שיוצרים אינטראקציה עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמכי הגילוי הבאים:

נקודת הקצה של השירות

נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות ה-API. לשירות אחד יכולות להיות כמה נקודות קצה של שירות. לשירות הזה יש את נקודת הקצה הבאה של השירות, וכל מזהי ה-URI הבאים הם יחסיים לנקודת הקצה של השירות:

  • https://dv360outofhomeseller.googleapis.com

משאב ל-REST: v1beta1

שיטות
lookupByExternalId POST /v1beta1:lookupByExternalId
הפונקציה מאחזרת את כל הישויות לפי המזהה החיצוני שצוין בבקשה.

משאב REST: v1beta1.adPlays

שיטות
create POST /v1beta1/adPlays
יצירת הפעלת מודעה.
createWithExternalIds POST /v1beta1/adPlays:createWithExternalIds
יצירת הפעלת מודעה עם מזהים חיצוניים.

מקור מידע ל-REST: v1beta1.adUnits

שיטות
create POST /v1beta1/adUnits
יצירה של יחידת מודעות חדשה.
delete DELETE /v1beta1/{name=adUnits/*}
מחיקה של יחידת מודעות קיימת.
get GET /v1beta1/{name=adUnits/*}
אחזור של יחידת מודעות בודדת.
list GET /v1beta1/adUnits
הרשימה כוללת יחידות של מודעות.
patch PATCH /v1beta1/{adUnit.name=adUnits/*}
עדכון של יחידת מודעות קיימת.

מקור מידע ל-REST: v1beta1.availabilityOrders

שיטות
complete POST /v1beta1/{name=availabilityOrders/*}:complete
סימון הזמנת זמינות קיימת כ'הושלמה'.
get GET /v1beta1/{name=availabilityOrders/*}
אחזור של הזמנת זמינות ספציפית.
list GET /v1beta1/availabilityOrders
מפרט את הזמנות הזמינות.

מקור מידע ל-REST: v1beta1.availabilityOrders.availabilityLines

שיטות
complete POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:complete
סימון שורת זמינות קיימת כ'הושלמה'.
get GET /v1beta1/{name=availabilityOrders/*/availabilityLines/*}
מאחזר שורה בודדת של הזמנת זמינות.
list GET /v1beta1/{parent=availabilityOrders/*}/availabilityLines
רשומים שורות של הזמנת זמינות.
reject POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:reject
סימון שורת זמינות קיימת כ'נדחתה'.

מקור מידע ל-REST: v1beta1.creativeAssets

שיטות
get GET /v1beta1/{name=creativeAssets/*}
אחזור של נכס קריאייטיב בודד.
list GET /v1beta1/creativeAssets
רשומים נכסי קריאייטיב.
patch PATCH /v1beta1/{creativeAsset.name=creativeAssets/*}
עדכון של נכס קריאייטיב קיים.

משאב ל-REST: v1beta1.orders

שיטות
get GET /v1beta1/{name=orders/*}
אחזור הזמנה בודדת.
list GET /v1beta1/orders
פירוט הזמנות.
patch PATCH /v1beta1/{order.name=orders/*}
עדכון הזמנה קיימת.

מקור מידע ל-REST: v1beta1.orders.lines

שיטות
book POST /v1beta1/{name=orders/*/lines/*}:book
יסומן שורה קיימת.
get GET /v1beta1/{name=orders/*/lines/*}
אחזור של שורה נפרדת להזמנה.
list GET /v1beta1/{parent=orders/*}/lines
רשימת השורות בהזמנה.
patch PATCH /v1beta1/{line.name=orders/*/lines/*}
מעדכן שורה קיימת.
reject POST /v1beta1/{name=orders/*/lines/*}:reject
דחיית שורה קיימת.
reserve POST /v1beta1/{name=orders/*/lines/*}:reserve
שמירת שורה קיימת.

מקור מידע ל-REST: v1beta1.orders.lines.assignments

שיטות
approve POST /v1beta1/{name=orders/*/lines/*/assignments/*}:approve
אישור מטלה קיימת.
disapprove POST /v1beta1/{name=orders/*/lines/*/assignments/*}:disapprove
דחייה של הקצאה קיימת.
get GET /v1beta1/{name=orders/*/lines/*/assignments/*}
אחזור של הקצאה בודדת לשורה.
list GET /v1beta1/{parent=orders/*/lines/*}/assignments
רשומים הקצאות של קו.
patch PATCH /v1beta1/{assignment.name=orders/*/lines/*/assignments/*}
עדכון מטלה קיימת.

מקור מידע ל-REST: v1beta1.products

שיטות
create POST /v1beta1/products
יצירת מוצר חדש.
get GET /v1beta1/{name=products/*}
מאחזר מוצר יחיד.
list GET /v1beta1/products
פירוט המוצרים.
patch PATCH /v1beta1/{product.name=products/*}
עדכון מוצר קיים.

משאב ל-REST: v1.sellers.adPlays

שיטות
batchCreate POST /v1/{parent=sellers/*}/adPlays:batchCreate
יצירת הפעלות חדשות של מודעות בכמות גדולה.
create POST /v1/{parent=sellers/*}/adPlays
יצירת הפעלת מודעה.

משאב ל-REST: v1.sellers.adUnits

שיטות
create POST /v1/{parent=sellers/*}/adUnits
יצירה של יחידת מודעות חדשה.
delete DELETE /v1/{name=sellers/*/adUnits/*}
מחיקה של יחידת מודעות קיימת.
get GET /v1/{name=sellers/*/adUnits/*}
אחזור של יחידת מודעות בודדת.
list GET /v1/{parent=sellers/*}/adUnits
הרשימה כוללת יחידות של מודעות.
patch PATCH /v1/{adUnit.name=sellers/*/adUnits/*}
עדכון של יחידת מודעות קיימת.

משאב ל-REST: v1.sellers.adUnits.impressionSchedules

שיטות
batchUpdate POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules:batchUpdate
מתבצע עדכון של לוחות הזמנים לחשיפות בבת אחת.
create POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
יצירת לוח זמנים חדש לחשיפות.
get GET /v1/{name=sellers/*/adUnits/*/impressionSchedules/*}
מאחזר לוח זמנים של חשיפות בודדות.
list GET /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
מפרט את תזמוני החשיפות.
patch PATCH /v1/{impressionSchedule.name=sellers/*/adUnits/*/impressionSchedules/*}
עדכון של לוח זמנים קיים לחשיפות.

משאב ל-REST: v1.sellers.availabilityOrders

שיטות
complete POST /v1/{name=sellers/*/availabilityOrders/*}:complete
סימון הזמנת זמינות קיימת כ'הושלמה'.
get GET /v1/{name=sellers/*/availabilityOrders/*}
אחזור של הזמנת זמינות ספציפית.
list GET /v1/{parent=sellers/*}/availabilityOrders
מפרט את הזמנות הזמינות.

משאב REST: v1.sellers.availabilityOrders.availabilityLines

שיטות
complete POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:complete
סימון שורת זמינות קיימת כ'הושלמה'.
get GET /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}
מאחזר שורה בודדת של הזמנת זמינות.
list GET /v1/{parent=sellers/*/availabilityOrders/*}/availabilityLines
רשומים שורות של הזמנת זמינות.
reject POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:reject
סימון שורת זמינות קיימת כ'נדחתה'.

משאב ל-REST: v1.sellers.creativeAssets

שיטות
get GET /v1/{name=sellers/*/creativeAssets/*}
אחזור של נכס קריאייטיב בודד.
list GET /v1/{parent=sellers/*}/creativeAssets
רשומים נכסי קריאייטיב.
patch PATCH /v1/{creativeAsset.name=sellers/*/creativeAssets/*}
עדכון של נכס קריאייטיב קיים.

משאב ל-REST: v1.sellers.orders

שיטות
completeOrderBooking POST /v1/{order=sellers/*/orders/*}:completeOrderBooking
משלים את הזמנת ההזמנה.
completeOrderReservation POST /v1/{order=sellers/*/orders/*}:completeOrderReservation
משלים את הזמנת ההזמנה.
create POST /v1/{parent=sellers/*}/orders
יוצרת הזמנה חדשה.
get GET /v1/{name=sellers/*/orders/*}
אחזור הזמנה בודדת.
list GET /v1/{parent=sellers/*}/orders
פירוט הזמנות.
patch PATCH /v1/{order.name=sellers/*/orders/*}
עדכון הזמנה קיימת.

משאב ל-REST: v1.sellers.orders.lines

שיטות
book POST /v1/{name=sellers/*/orders/*/lines/*}:book
יסומן שורה קיימת.
create POST /v1/{parent=sellers/*/orders/*}/lines
יוצרת שורה חדשה.
get GET /v1/{name=sellers/*/orders/*/lines/*}
אחזור של שורה נפרדת להזמנה.
list GET /v1/{parent=sellers/*/orders/*}/lines
רשימת השורות בהזמנה.
patch PATCH /v1/{line.name=sellers/*/orders/*/lines/*}
מעדכן שורה קיימת.
reject POST /v1/{name=sellers/*/orders/*/lines/*}:reject
דחיית שורה קיימת.
reserve POST /v1/{name=sellers/*/orders/*/lines/*}:reserve
שמירת שורה קיימת.

משאב ל-REST: v1.sellers.orders.lines.assignments

שיטות
approve POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:approve
אישור מטלה קיימת.
disapprove POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:disapprove
דחייה של הקצאה קיימת.
get GET /v1/{name=sellers/*/orders/*/lines/*/assignments/*}
אחזור של הקצאה בודדת לשורה.
list GET /v1/{parent=sellers/*/orders/*/lines/*}/assignments
רשומים הקצאות של קו.
patch PATCH /v1/{assignment.name=sellers/*/orders/*/lines/*/assignments/*}
עדכון מטלה קיימת.

משאב ל-REST: v1.sellers.products

שיטות
create POST /v1/{parent=sellers/*}/products
יצירת מוצר חדש.
delete DELETE /v1/{name=sellers/*/products/*}
מחיקת מוצר קיים.
get GET /v1/{name=sellers/*/products/*}
מאחזר מוצר יחיד.
list GET /v1/{parent=sellers/*}/products
פירוט המוצרים.
patch PATCH /v1/{product.name=sellers/*/products/*}
עדכון מוצר קיים.