בתיבת הדו שיח הזו רשומים הזמנות עם התחייבות שיש למשתמש הנוכחי גישה אליהן.
הסדר מוגדר על ידי הפרמטר orderBy
. אם לא צוין filter
על ידי entityStatus
, הזמנות מובטחות עם סטטוס ישות ENTITY_STATUS_ARCHIVED
לא ייכללו בתוצאות.
בקשת HTTP
GET https://displayvideo.googleapis.com/v1/guaranteedOrders
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
pageSize |
גודל הדף המבוקש. חייב להיות בין |
pageToken |
אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של |
orderBy |
שדה שלפיו תמיין את הרשימה. הערכים הקבילים הם:
סדר המיון המוגדר כברירת מחדל הוא עולה. כדי לציין סדר יורד לשדה מסוים, צריך להוסיף את הסיומת 'description' לשם השדה. לדוגמה, |
filter |
מאפשר סינון לפי שדות של סדר מובטח.
שדות נתמכים: * דוגמאות:
האורך המקסימלי של השדה הזה הוא 500 תווים. מידע נוסף זמין במדריך שלנו בנושא סינון בקשות |
פרמטר איחוד זיהוי הישות ב-DV360 שבה הבקשה נשלחת. הבקשה LIST תחזיר רק ישויות הזמנה מובטחות שאפשר לגשת אליהן לישות ב-DV360 שצוינה ב |
|
partnerId |
המזהה של השותף שיש לו גישה להזמנה המובטחת. |
advertiserId |
המזהה של המפרסם שיש לו גישה להזמנה המובטחת. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"guaranteedOrders": [
{
object ( |
שדות | |
---|---|
guaranteedOrders[] |
רשימת ההזמנות המובטחות. אם הרשימה ריקה, היא לא תופיע. |
nextPageToken |
אסימון לאחזור של דף התוצאות הבא. יש להעביר את הערך הזה בשדה |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/display-video
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.