Method: advertisers.adAssets.upload

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

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

אפשר להעלות רק נכסים עם AdAssetType AD_ASSET_TYPE_IMAGE.

בקשת HTTP

  • ‫URI להעלאה, לבקשות להעלאת מדיה:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/adAssets:uploadAdAsset
  • ‫URI של מטא-נתונים, לבקשות של מטא-נתונים בלבד:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adAssets:uploadAdAsset

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

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

פרמטרים
advertiserId

string (int64 format)

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "filename": string,
  "adAssetType": enum (AdAssetType)
}
שדות
filename

string

חובה. שם הקובץ של נכס המודעה, כולל סיומת הקובץ.

שם הקובץ חייב להיות מקודד ב-UTF-8, והגודל המקסימלי שלו הוא 240 בייטים.
adAssetType

enum (AdAssetType)

חובה. סוג הנכס שמצורף למודעה.

יש תמיכה רק ב-AD_ASSET_TYPE_IMAGE.

גוף התשובה

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

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

ייצוג ב-JSON 
{
  "adAsset": {
    object (AdAsset)
  }
}
שדות
adAsset

object (AdAsset)

הנכס שנוצר שמצורף למודעה.

היקפי הרשאה

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

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

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