Method: advertisers.assets.upload

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
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.