גודל הדף המבוקש. חייב להיות בין 1 ל-200. אם לא צויין ערך, ברירת המחדל תהיה 100.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method guaranteedOrders.list. אם לא מציינים זאת, המערכת תחזיר את דף התוצאות הראשון.
orderBy
string
השדה שלפיו צריך למיין את הרשימה. הערכים הקבילים הם:
displayName (ברירת מחדל)
ברירת המחדל של סדר המיון היא בסדר עולה. כדי לציין סדר יורד בשדה, הסיומת 'תיאור' יש להוסיף לשם השדה. לדוגמה, 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_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"
מציינת באיזו ישות ב-DV360 הבקשה נשלחת. בקשת ה-LIST תחזיר רק ישויות של הזמנה מובטחת שניתן לגשת אליהן לישות ב-DV360 שצוינה ב-accessor. accessor יכול להיות רק אחת מהאפשרויות הבאות:
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-09-09 (שעון UTC)."],[[["Lists guaranteed orders accessible to the current user, filterable by order ID, exchange, display name, and entity status."],["Results can be sorted by display name and are paginated with default page size of 100."],["Requires specifying an accessor (partner ID or advertiser ID) to identify the DV360 entity context for the request."],["Uses the `https://www.googleapis.com/auth/display-video` OAuth scope for authorization."]]],["This document details how to list accessible guaranteed orders using the Display & Video 360 API. Use a `GET` request to `guaranteedOrders` endpoint. Parameters include `pageSize`, `pageToken`, `orderBy`, and `filter` for sorting and filtering results. You must specify a `partnerId` or `advertiserId`. The response returns a list of `guaranteedOrders` and a `nextPageToken` for pagination. Authorization requires the `display-video` OAuth scope. `ENTITY_STATUS_ARCHIVED` is excluded unless it is specifically filtered for.\n"]]