גודל הדף המבוקש. חייב להיות בין 1 לבין 10000. אם לא צוין ערך, ברירת המחדל תהיה 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת אמור להציג.
בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת לשיטה sites.list. אם לא יצוין, יוצג דף התוצאות הראשון.
orderBy
string
השדה שלפיו רוצים למיין את הרשימה. הערכים הקבילים הם:
urlOrAppId (ברירת מחדל)
סדר המיון שמוגדר כברירת מחדל הוא עולה. כדי לציין סדר יורד בשדה, צריך להוסיף את הסיומת 'desc' לשם השדה. דוגמה: urlOrAppId desc
filter
string
מאפשר סינון לפי שדות של אתרים.
תחביר נתמך:
ביטויי סינון לאחזור אתרים יכולים לכלול רק הגבלה אחת לכל היותר.
הפורמט של הגבלה הוא {field} {operator} {value}.
בכל השדות צריך להשתמש באופרטור HAS (:).
השדות הנתמכים:
urlOrAppId
דוגמאות:
כל האתרים שבהם כתובת ה-URL או מזהה האפליקציה מכילים את המילה 'google': urlOrAppId : "google"
[[["התוכן קל להבנה","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"]],["עדכון אחרון: 2025-02-25 (שעון UTC)."],[[["Lists sites within a given Display & Video 360 channel using a `GET` request."],["Requires specifying the parent channel's ID and the owning partner or advertiser ID."],["Allows filtering and sorting results with query parameters like `filter` and `orderBy`."],["Supports pagination with `pageSize` and `pageToken` to retrieve large result sets."],["Needs authorization with the `https://www.googleapis.com/auth/display-video` scope."]]],["This document outlines how to retrieve a list of sites within a channel using a `GET` HTTP request. The request URL requires `channelId` and either `partnerId` or `advertiserId` as path parameters to specify the owning entity. Query parameters, including `pageSize`, `pageToken`, `orderBy`, and `filter`, allow for result customization. The request body must be empty and requires OAuth 2.0 authorization. A successful response returns a `ListSitesResponse` instance containing the requested sites.\n"]]