בתיבת הדו-שיח הזו מפורטים מקורות של מלאי שטחי פרסום שניתן לגשת אליהם למשתמש הנוכחי.
הסדר מוגדר על ידי הפרמטר orderBy. אם לא יצוין filter של entityStatus, תוצאות החיפוש לא יכללו מקורות של מלאי שטחי פרסום עם סטטוס הישות ENTITY_STATUS_ARCHIVED.
בקשת HTTP
GET https://displayvideo.googleapis.com/v1/inventorySources
גודל הדף המבוקש. חייב להיות בין 1 ל-200. אם לא צויין ערך, ברירת המחדל תהיה 100.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method inventorySources.list. אם לא מציינים זאת, המערכת תחזיר את דף התוצאות הראשון.
orderBy
string
השדה שלפיו צריך למיין את הרשימה. הערכים הקבילים הם:
displayName (ברירת מחדל)
ברירת המחדל של סדר המיון היא בסדר עולה. כדי לציין סדר יורד בשדה, הסיומת 'תיאור' יש להוסיף לשם השדה. לדוגמה, displayName desc.
filter
string
מאפשר סינון לפי שדות של מקור המלאי.
תחביר נתמך:
ביטויי הסינון מורכבים מהגבלה אחת או יותר.
אפשר לשלב את ההגבלות באמצעות אופרטורים לוגיים AND או OR. רצף של הגבלות משתמש באופן מרומז ב-AND.
הגבלה היא בפורמט {field} {operator} {value}.
צריך להשתמש באופרטור EQUALS (=) בכל השדות.
שדות נתמכים:
status.entityStatus
commitment
deliveryMethod
rateDetails.rateType
exchange
דוגמאות:
כל המקורות הפעילים של מלאי שטחי הפרסום: status.entityStatus="ENTITY_STATUS_ACTIVE"
מקורות של מלאי שטחי הפרסום השייכים לבורסות הפרסום של Google Ad Manager או של Rubicon: exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="EXCHANGE_RUBICON"
פרמטר האיחוד accessor. חובה. מציינת באיזו ישות ב-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-12 (שעון UTC)."],[[["Lists inventory sources accessible to the current user, ordered by `orderBy` parameter and excluding archived sources unless specified in the `filter`."],["The API request is a `GET` request to `https://displayvideo.googleapis.com/v1/inventorySources` with optional query parameters for pagination, sorting, and filtering."],["Request body should be empty, and the response will contain a list of inventory sources and a token for retrieving the next page of results."],["Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope."]]],["This document details how to use the Display & Video 360 API to list accessible inventory sources. Users send a `GET` request to the specified URL, with optional query parameters for `pageSize`, `pageToken`, `orderBy`, and `filter`, to refine the results. The request must identify the accessible DV360 entity via the required union parameter `accessor` which can be a `partnerId` or `advertiserId`. The response contains a list of `inventorySources` and a `nextPageToken` for pagination. Archived inventory sources are excluded unless specified by a filter. The request body must be empty, and authorization requires a specific OAuth scope.\n"]]