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.