גודל הדף המבוקש. חייב להיות בין 1 ל-200. אם לא צויין ערך, ברירת המחדל תהיה 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method customLists.list. אם לא מציינים זאת, המערכת תחזיר את דף התוצאות הראשון.
orderBy
string
השדה שלפיו צריך למיין את הרשימה. הערכים הקבילים הם:
customListId (ברירת מחדל)
displayName
סדר המיון שמוגדר כברירת מחדל הוא עולה. כדי לציין סדר יורד בשדה, הסיומת 'תיאור' יש להוסיף לשם השדה. דוגמה: displayName desc
filter
string
מאפשר סינון לפי שדות רשימה מותאמים אישית.
תחביר נתמך:
ביטויי סינון לרשימות בהתאמה אישית יכולים לכלול רק הגבלה אחת לכל היותר.
הפורמט של הגבלה הוא {field} {operator} {value}.
צריך להשתמש באופרטור HAS (:) בכל השדות.
שדות נתמכים:
displayName
דוגמאות:
כל הרשימות בהתאמה אישית שהשם המוצג שלהן מכיל את המילה 'Google': displayName:"Google".
פרמטר האיחוד 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)."],[[["This document details how to use the Display & Video 360 API to list custom lists, including specifying the order, page size, filtering, and required authorizations."],["The API request is a standard HTTP GET request to a specific URL with query parameters for customization."],["Responses include a list of custom lists (if any), and a token for retrieving subsequent pages of results."],["Users need to authorize their requests with the `https://www.googleapis.com/auth/display-video` OAuth scope."]]],["This document details how to list custom lists using the Display & Video 360 API. The core action is a `GET` request to `https://displayvideo.googleapis.com/v2/customLists`. You can filter results with `filter`, sort with `orderBy`, and define page size with `pageSize`. Pagination uses the `pageToken`, and the `accessor` parameter, like `advertiserId`, is required to specify the context. The response provides an array of `customLists` and a `nextPageToken` for subsequent pages. An empty request body is needed. OAuth scope `https://www.googleapis.com/auth/display-video` is needed.\n"]]