מעלה נכס. הפונקציה מחזירה את המזהה של הנכס החדש שהועלה, אם הפעולה בוצעה ללא שגיאות. גודל הקובץ של הנכס יכול להיות עד 10MB לתמונות, 200MB לקובצי ZIP ו-1GB לסרטונים.
יש להשתמש בהן בתהליך ההעלאה של מדיה מרובת חלקים. ניתן למצוא דוגמאות לשימוש בספריות לקוח שסופקו במדריך ליצירת קריאייטיבים.
בקשת HTTP
- URI של העלאה, לבקשות להעלאת מדיה:
POST https://displayvideo.googleapis.com/upload/v1/advertisers/{advertiserId}/assets
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
advertiserId |
חובה. המזהה של המפרסם שהנכס הזה שייך לו. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "filename": string } |
שדות | |
---|---|
filename |
חובה. שם הקובץ של הנכס, כולל סיומת הקובץ. שם הקובץ צריך להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים. |
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
הודעת תגובה עבור assets.upload
.
ייצוג JSON |
---|
{
"asset": {
object ( |
שדות | |
---|---|
asset |
הנכס שהועלה, אם הוא בוצע בהצלחה. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/display-video
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.