Method: advertisers.adAssets.list

רשימת הנכסים שמצורפים למודעות לפי מזהה מפרסם.

תמיכה רק באחזור נכסים של AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO.

בקשת HTTP

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

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

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

פרמטרים
advertiserId

string (int64 format)

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

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

פרמטרים
pageSize

integer

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

string

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

string

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

  • entityStatus
  • youtubeVideoAsset.youtubeVideoId
  • ‫adAssetId (ברירת מחדל)

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

string

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

תחביר נתמך:

  • ההגבלות הן בפורמט {field} {operator} {value}.
  • צריך להשתמש באופרטור EQUALS (=) בכל השדות.

שדות נתמכים:

  • youtubeVideoAsset.youtubeVideoId
  • entityStatus

דוגמאות:

  • כל נכסי מודעות הווידאו הפעילים ב-YouTube שמשויכים למפרסם: entityStatus=ENTITY_STATUS_ACTIVE

גוף הבקשה

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

גוף התשובה

הודעת תשובה ל-adAssets.list.

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

ייצוג ב-JSON 
{
  "adAssets": [
    {
      object (AdAsset)
    }
  ],
  "nextPageToken": string
}
שדות
adAssets[]

object (AdAsset)

רשימת הנכסים שמצורפים למודעות. הרשימה תכיל רק נכסים מסוג AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO.

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

string

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

היקפי הרשאה

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

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

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