גודל הדף המבוקש. חייב להיות בין 1 ל-200. אם לא צויין ערך, ברירת המחדל תהיה 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method googleAudiences.list. אם לא מציינים זאת, המערכת תחזיר את דף התוצאות הראשון.
orderBy
string
השדה שלפיו צריך למיין את הרשימה. הערכים הקבילים הם:
googleAudienceId (ברירת מחדל)
displayName
ברירת המחדל של סדר המיון היא בסדר עולה. כדי לציין סדר יורד בשדה, הסיומת 'תיאור' יש להוסיף לשם השדה. דוגמה: displayName desc
filter
string
מאפשר סינון לפי שדות קהל ב-Google.
תחביר נתמך:
ביטויי סינון לקהלים ב-Google יכולים להכיל רק הגבלה אחת לכל היותר.
הגבלה היא בצורה הבאה: {field} {operator} {value}.
צריך להשתמש באופרטור HAS (:) בכל השדות.
שדות נתמכים:
displayName
דוגמאות:
כל הקהלים של Google שהשם המוצג שלהם מכיל את המילה "Google": displayName:"Google".
פרמטר האיחוד accessor. חובה. מציינת באיזו ישות ב-DV360 הבקשה נשלחת. בקשת ה-LIST תחזיר רק ישויות קהלים של Google שניתן לגשת אליהן לישות ב-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 Google audiences, with the order determined by the `orderBy` parameter and results filtered using the `filter` parameter."],["Supports pagination using `pageSize` and `pageToken` parameters to retrieve and navigate through the list of Google audiences."],["Requires specifying an `accessor` parameter to identify the DV360 entity (partner or advertiser) for access control."],["Uses a GET request to `https://displayvideo.googleapis.com/v2/googleAudiences` with optional query parameters for filtering and ordering."],["Needs authorization with the `https://www.googleapis.com/auth/display-video` scope for accessing the Display & Video 360 API."]]],["This document outlines the process of listing Google audiences via the Display & Video 360 API. Key actions include using a `GET` request to the specified URL. Requests can be customized using query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter`. An `accessor` parameter, either `partnerId` or `advertiserId`, is required. The API returns a list of `googleAudiences` and a `nextPageToken` for pagination, with responses structured in JSON. OAuth scope `https://www.googleapis.com/auth/display-video` is required.\n"]]