העלאת נכס. הפונקציה מחזירה את המזהה של הנכס החדש שהועלה, אם הפעולה בוצעה ללא שגיאות. גודל הקובץ של הנכס צריך להיות עד 10MB לתמונות, עד 200MB לקובצי ZIP ועד 1GB לסרטונים.
יש להשתמש בהן בתהליך ההעלאה של מדיה מרובת חלקים. ניתן למצוא דוגמאות לשימוש בספריות לקוח שסופקו במדריך ליצירת קריאייטיבים.
בקשת HTTP
- URI של העלאה, לבקשות להעלאת מדיה:
POST https://displayvideo.googleapis.com/upload/v2/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.