Method: advertisers.assets.upload

העלאת נכס. אם הפעולה בוצעה בהצלחה, הפונקציה מחזירה את המזהה של הנכס שהועלה. גודל קובץ הנכס צריך להיות עד 10MB לתמונות, עד 200MB לקובצי ZIP ועד 1GB לסרטונים.

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

בקשת HTTP

  • ‫URI להעלאה, לבקשות להעלאת מדיה:
    POST https://displayvideo.googleapis.com/upload/v3/advertisers/{advertiserId}/assets

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

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

פרמטרים
advertiserId

string (int64 format)

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

גוף הבקשה

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

ייצוג ב-JSON
{
  "filename": string
}
שדות
filename

string

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

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

גוף התשובה

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

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

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

object (Asset)

הנכס שהועלה, אם ההעלאה בוצעה בהצלחה.

היקפי הרשאה

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

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

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