אפשרות. גודל הדף המבוקש. חייב להיות בין 1 ל-200. אם לא צוין ערך, ברירת המחדל תהיה 100. מחזירה קוד שגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אפשרות. אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method adGroups.list. אם לא מציינים שום אפשרות, יוחזר דף התוצאות הראשון.
orderBy
string
אפשרות. שדה שלפיו תמיין את הרשימה. הערכים הקבילים הם:
displayName (ברירת מחדל)
entityStatus
סדר המיון המוגדר כברירת מחדל הוא עולה. כדי לציין סדר יורד לשדה מסוים, צריך להוסיף את הסיומת 'description' לשם השדה. דוגמה: displayName desc
filter
string
אפשרות. מאפשר סינון לפי שדות מותאמים אישית של קבוצות מודעות.
תחביר נתמך:
ביטויי סינון מורכבים מהגבלה אחת או יותר.
אפשר לשלב את ההגבלות באמצעות AND ו-OR. רצף של הגבלות משתמש באופן לא מפורש ב-AND.
ההגבלה יכולה להיות {field} {operator} {value}.
בכל השדות יש להשתמש באופרטור EQUALS (=).
מאפיינים נתמכים:
adGroupId
displayName
entityStatus
lineItemId
adGroupFormat
דוגמאות:
כל קבוצות המודעות שנכללות בפריט: lineItemId="1234"
כל ENTITY_STATUS_ACTIVE או ENTITY_STATUS_PAUSED קבוצות המודעות AD_GROUP_FORMAT_IN_STREAM של מפרסם: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
adGroupFormat="AD_GROUP_FORMAT_IN_STREAM"