Method: advertisers.adAssets.list

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

אפשר לאחזר רק נכסים של AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO.

בקשת HTTP

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

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

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

פרמטרים
advertiserId

string (int64 format)

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

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

פרמטרים
pageSize

integer

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

string

אופציונלי. אסימון שמזהה את דף התוצאות שהשרת צריך להחזיר. בדרך כלל, זה הערך של nextPageToken שמוחזר מהקריאה הקודמת ל-method‏ 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 בקריאה הבאה ל-method‏ adAssets.list כדי לאחזר את דף התוצאות הבא.

היקפי הרשאות

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

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

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