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.