חובה. המזהה של המפרסם שאליה שייכות קבוצות המודעות.
פרמטרים של שאילתה
פרמטרים
pageSize
integer
זה שינוי אופציונלי. גודל הדף המבוקש. חייב להיות בין 1 לבין 200. אם לא צוין ערך, ברירת המחדל תהיה 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
זה שינוי אופציונלי. אסימון שמזהה דף תוצאות שהשרת אמור להציג. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת לשיטה adGroups.list. אם לא יצוין, יוצג דף התוצאות הראשון.
orderBy
string
זה שינוי אופציונלי. השדה שלפיו רוצים למיין את הרשימה. הערכים הקבילים הם:
displayName (ברירת מחדל)
entityStatus
סדר המיון שמוגדר כברירת מחדל הוא עולה. כדי לציין סדר יורד בשדה, צריך להוסיף את הסיומת 'desc' לשם השדה. דוגמה: displayName desc
filter
string
זה שינוי אופציונלי. מאפשר סינון לפי שדות מותאמים אישית של קבוצות של מודעות.
תחביר נתמך:
ביטויי מסננים מורכבים מהגבלה אחת או יותר.
אפשר לשלב הגבלות באמצעות AND ו-OR. ברצף של הגבלות נעשה שימוש משתמע ב-AND.
הפורמט של הגבלה הוא {field} {operator} {value}.
בכל השדות צריך להשתמש באופרטור EQUALS (=).
המאפיינים הנתמכים:
adGroupId
displayName
entityStatus
lineItemId
adGroupFormat
דוגמאות:
כל קבוצות המודעות בפריט: lineItemId="1234"
כל קבוצות המודעות מסוג ENTITY_STATUS_ACTIVE או ENTITY_STATUS_PAUSEDAD_GROUP_FORMAT_IN_STREAM בחשבון מפרסם: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
adGroupFormat="AD_GROUP_FORMAT_IN_STREAM"
[[["התוכן קל להבנה","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 ad groups belonging to a specified advertiser using the `GET` method and the `adGroups.list` endpoint."],["Allows filtering, sorting, and pagination of results via query parameters such as `filter`, `orderBy`, `pageSize`, and `pageToken`."],["Request body should be empty, and the response includes an array of `AdGroup` objects and a `nextPageToken` for retrieving further results."],["Requires authorization with the `https://www.googleapis.com/auth/display-video` scope."]]],["This resource lists ad groups using a `GET` request to a specified URL, including the advertiser ID as a path parameter. Optional query parameters allow for pagination (`pageSize`, `pageToken`), sorting (`orderBy`), and filtering. The request body is empty. The response body contains a list of ad groups and a `nextPageToken` for retrieving additional results. Access requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"]]