החל מ-8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין בדף ההוצאה משימוש.
גודל הדף המבוקש. חייב להיות בין 1 לבין 200. אם לא צוין ערך, ברירת המחדל היא 100.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת אמור להציג. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת לשיטה guaranteedOrders.list. אם לא יצוין, יוצג דף התוצאות הראשון.
orderBy
string
השדה שלפיו רוצים למיין את הרשימה. הערכים הקבילים הם:
displayName (ברירת מחדל)
סדר המיון שמוגדר כברירת מחדל הוא עולה. כדי לציין סדר יורד בשדה, צריך להוסיף את הסיומת 'desc' לשם השדה. לדוגמה, displayName desc.
filter
string
מאפשר לסנן לפי שדות של הזמנות מובטחות.
ביטויי מסננים מורכבים מהגבלה אחת או יותר.
אפשר לשלב הגבלות באמצעות אופרטורים לוגיים מסוג AND או OR. רצף של הגבלות משתמש ב-AND באופן משתמע.
הפורמט של הגבלה הוא {field} {operator} {value}.
בכל השדות צריך להשתמש באופרטור EQUALS (=).
שדות נתמכים: * guaranteedOrderId * exchange * displayName * status.entityStatus
דוגמאות:
כל ההזמנות הפעילות עם התחייבות למחיר הנמוך ביותר: status.entityStatus="ENTITY_STATUS_ACTIVE"
הזמנות מובטחות ששייכות ל-Google Ad Manager או ל-Rubicon Exchange: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"
מזהה את הישות ב-DV360 שבה הבקשה נשלחת. הבקשה ל-LIST תחזיר רק ישויות של הזמנות מובטחות שזמינות לישות ב-DV360 שצוינה ב-accessor. הערך של accessor יכול להיות רק אחת מהאפשרויות הבאות:
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eLists guaranteed orders accessible to the current user, filterable by order ID, exchange, display name, and entity status.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e for retrieving large result sets.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e authorization scope for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of guaranteed orders and a token for retrieving the next page of results, if available.\u003c/p\u003e\n"],["\u003cp\u003eAccessible via a \u003ccode\u003eGET\u003c/code\u003e request to \u003ccode\u003ehttps://displayvideo.googleapis.com/v3/guaranteedOrders\u003c/code\u003e.\u003c/p\u003e\n"]]],["This document outlines how to retrieve a list of guaranteed orders via an HTTP GET request to `https://displayvideo.googleapis.com/v3/guaranteedOrders`. Key actions include setting optional query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` to customize the results. `partnerId` or `advertiserId` are required parameters. The response includes a list of `guaranteedOrders` and a `nextPageToken` for pagination. Filtering by fields like `entityStatus` is possible, and specific authorization scopes are needed. The request body should be empty.\n"],null,[]]
