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