Method: advertisers.adGroupAds.list

רשימה של מודעות בקבוצת מודעות.

בקשת HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroupAds

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
advertiserId

string (int64 format)

חובה. המזהה של המפרסם שהמודעות שייכות אליו.

פרמטרים של שאילתה

פרמטרים
pageSize

integer

אופציונלי. גודל הדף המבוקש. חייב להיות בין 1 לבין 100. אם לא מציינים ערך, ברירת המחדל היא 100. מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken

string

אופציונלי. אסימון שמזהה איזה דף תוצאות השרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שמוחזר מהקריאה הקודמת לשיטת adGroupAds.list. אם לא מציינים ערך, יוצג דף התוצאות הראשון.
orderBy

string

אופציונלי. השדה שלפיו רוצים למיין את הרשימה. ערכים קבילים:

  • ‫displayName (ברירת מחדל)
  • entityStatus

סדר המיון שמוגדר כברירת מחדל הוא סדר עולה. כדי לציין סדר יורד בשדה, צריך להוסיף את הסיומת desc לשם השדה. דוגמה: displayName desc
filter

string

אופציונלי. אפשר לסנן לפי שדות של מודעות בקבוצת מודעות.

תחביר נתמך:

  • ביטויי סינון מורכבים מהגבלה אחת או יותר.
  • אפשר לשלב הגבלות באמצעות AND ו-OR. רצף של הגבלות משתמש באופן מרומז ב-AND.
  • הגבלה היא בפורמט {field} {operator} {value}.
  • בכל השדות צריך להשתמש באופרטור EQUALS (=).

שדות נתמכים:

  • adGroupId
  • displayName
  • entityStatus
  • adGroupAdId

דוגמאות:

  • כל המודעות בקבוצת מודעות מסוימת: adGroupId="1234"
  • כל המודעות בקבוצת מודעות שבה הערך של entityStatus הוא ENTITY_STATUS_ACTIVE או ENTITY_STATUS_PAUSED: (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND adGroupId="12345"

האורך של השדה הזה צריך להיות עד 500 תווים.

מידע נוסף זמין במדריך בנושא בקשות לסינון LIST.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "adGroupAds": [
    {
      object (AdGroupAd)
    }
  ],
  "nextPageToken": string
}
שדות
adGroupAds[]

object (AdGroupAd)

רשימת המודעות.

אם הרשימה ריקה, היא לא תופיע.
nextPageToken

string

אסימון לאחזור של דף התוצאות הבא. מעבירים את הערך הזה בשדה pageToken בקריאה הבאה לשיטה adGroupAds.list כדי לאחזר את דף התוצאות הבא.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/display-video

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.