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