העלאת מדיה

תכונת העלאת המדיה מאפשרת לכם לאחסן נתונים שתוכלו להשתמש בהם ב-Display & Video 360. סוגי הנתונים שאולי תרצו להעלות כוללים תמונות, סרטונים, קובצי ZIP וכו'.

האפשרויות להעלאה

באמצעות Display & Video 360 API אפשר להעלות סוגים מסוימים של נתונים בינאריים או מדיה. במדריך למפתחים מפורטות המאפיינים של הנתונים שאפשר להעלות לכל משימה שדורשת העלאת מדיה:

גודל הקובץ המקסימלי להעלאה: כמות הנתונים המקסימלית שאפשר לאחסן באמצעות השיטה הזו.
סוגי MIME של מדיה שמתקבלים: סוגי הנתונים הבינאריים שאפשר לאחסן באמצעות השיטה הזו.

אפשר לשלוח בקשות העלאה בדרכים הבאות. מציינים את השיטה שבה משתמשים באמצעות הפרמטר uploadType.

העלאה פשוטה: uploadType=media. העברה מהירה של קבצים בגודל של עד 5MB.
העלאה מרובת חלקים: uploadType=multipart. העברה מהירה של קבצים ומטא-נתונים רלוונטיים. העברת הקובץ והמטא-נתונים, והכול בבקשה אחת.

כשמעלים מדיה, משתמשים ב-URI של /upload. משתמשים ב-URI הזה כשמעבירים את נתוני המדיה עצמם.

דוגמה:

  POST /upload/media/resource-name

העלאה פשוטה

בקשת העלאה פשוטה היא השיטה הכי פשוטה להעלאת קובץ. כדאי לבחור באפשרות הזו אם:

במקרה הצורך, אפשר להעלות את הקובץ שוב כי הוא קטן מספיק.
אין מטא-נתונים לשליחה. יכול להיות שזה נכון אם מטא-נתונים לא נחוצים או אם הם כלולים במקום אחר בבקשה.

כדי להשתמש בהעלאה פשוטה, שולחים בקשת POST או PUT ל-URI של השיטה /upload ומוסיפים את פרמטר השאילתה uploadType=media. לדוגמה:

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

כותרות ה-HTTP שבהן צריך להשתמש כשמבצעים העלאה פשוטה כוללות:

‫Content-Type. מגדירים את אחד מסוגי נתוני המדיה המקובלים של השיטה.
‫Content-Length. צריך להגדיר את מספר הבייטים שמעלים. לא נדרש אם משתמשים בקידוד העברה במקטעים.

העלאה מרובת חלקים

אם יש לכם מטא-נתונים לשליחה עם הנתונים שאתם רוצים להעלות, אתם יכולים לשלוח בקשת multipart/related. האפשרות הזו מתאימה אם הנתונים שאתם שולחים קטנים מספיק כדי להעלות אותם שוב, אם צריך.

כדי להשתמש בהעלאה מרובת חלקים, שולחים בקשת POST או PUT ל-URI של השיטה /upload ומוסיפים את פרמטר השאילתה uploadType=multipart. לדוגמה:

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

כותרות ה-HTTP ברמה העליונה שבהן צריך להשתמש כשיוצרים בקשת העלאה מרובת חלקים כוללות:

‫Content-Type. מגדירים את הערך multipart/related וכוללים את מחרוזת הגבול שמשמשת לזיהוי החלקים של הבקשה.
‫Content-Length. הערך שמוגדר הוא המספר הכולל של בייטים בגוף הבקשה. החלק של המדיה בבקשה צריך להיות קטן מגודל הקובץ המקסימלי שצוין לשיטה הזו.

גוף הבקשה מעוצב כסוג תוכן multipart/related [RFC2387] ומכיל בדיוק שני חלקים. החלקים מזוהים על ידי מחרוזת גבול, ואחרי מחרוזת הגבול הסופית מופיעים שני מקפים.

לכל חלק בבקשת ה-multipart צריך להוסיף כותרת Content-Type:

חלק המטא-נתונים: צריך להופיע ראשון, וContent-Type צריך להיות תואם לאחד מפורמטי המטא-נתונים המקובלים.
קטע מדיה: חייב להופיע שני, ו-Content-Type חייב להתאים לאחד מסוגי ה-MIME של המדיה שהשיטה מקבלת.

דוגמאות

אתם מעלים מדיה באמצעות Display & Video 360 API כדי לבצע משימות שונות. בקטע הזה מופיעות דוגמאות כבקשות curl.

העלאת נכס של קריאייטיב

כך מעלים נכס של קריאייטיב:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

מידע נוסף ודוגמאות קוד זמינים במדריך בנושא העלאת נכסי קריאייטיב.

העלאת קובץ סקריפט של בידינג בהתאמה אישית

כדי להעלות קובץ סקריפט:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

פרטים נוספים ודוגמאות קוד זמינים במדריך בנושא סקריפט להעלאה.

העלאת מדיה קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.