העלאת תמונה ממוזערת מותאמת אישית של סרטון ל-YouTube והגדרתה לסרטון.
השיטה הזו תומכת בהעלאת מדיה. הקבצים שמעלים צריכים לעמוד במגבלות הבאות:
- גודל הקובץ המקסימלי: 50MB
- סוגי MIME של מדיה שאפשר להעלות:
image/jpeg,image/png,application/octet-stream
השפעה על המכסה: העלות של קריאה ל-method הזו היא כ-50 יחידות מכסה.
תרחישים נפוצים לדוגמה
בקשה
בקשת HTTP
POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set
אישור
כדי לבצע את הבקשה הזו נדרשת הרשאה עם לפחות אחת מההרשאות הבאות (מידע נוסף על אימות והרשאה).
| היקף |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
פרמטרים
בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמופיעים ברשימה הם פרמטרים של שאילתה.
| פרמטרים | ||
|---|---|---|
| פרמטרים נדרשים | ||
videoId |
stringהפרמטר videoId מציין מזהה סרטון ב-YouTube שעבורו מסופקת התמונה הממוזערת המותאמת אישית של הסרטון. |
|
| פרמטרים אופציונליים | ||
onBehalfOfContentOwner |
stringהערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן ב-YouTube. הפרמטר onBehalfOfContentOwner מציין שפרטי ההרשאה של הבקשה מזהים משתמש ב-YouTube CMS שפועל בשם בעל התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן של YouTube שבבעלותם ובניהולם הרבה ערוצי YouTube שונים. הוא מאפשר לבעלי התוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוצים שלהם, בלי לספק פרטי כניסה לאימות לכל ערוץ בנפרד. חשבון מערכת ניהול התוכן (CMS) בפועל שהמשתמש מאמת באמצעותו חייב להיות מקושר לבעלי התוכן שצוינו ב-YouTube. |
|
גוף הבקשה
גוף הבקשה מכיל את התמונה הממוזערת שאתם מעלים. גוף הבקשה לא מכיל משאב thumbnail.
תשובה
אם הפעולה בוצעה ללא שגיאות, ה-method מחזירה גוף תגובה במבנה הבא:
{
"kind": "youtube#thumbnailSetResponse",
"etag": etag,
"items": [
thumbnail resource
]
}מאפיינים
בטבלה הבאה מוגדרים המאפיינים שמופיעים במשאב הזה:
| מאפיינים | |
|---|---|
kind |
stringמזהה את סוג משאב ה-API. הערך יהיה youtube#thumbnailSetResponse. |
etag |
etagה-Etag של מקור המידע הזה. |
items[] |
listרשימה של תמונות ממוזערות. |
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שה-API יכול להחזיר בתגובה לקריאה ל-method הזה. פרטים נוספים מופיעים במסמכי התיעוד בנושא הודעות שגיאה.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
badRequest (400) |
invalidImage |
תוכן התמונה שסיפקת לא תקין. |
badRequest (400) |
mediaBodyRequired |
הבקשה לא כוללת את תוכן התמונה. |
forbidden (403) |
forbidden |
אי אפשר להגדיר את התמונה הממוזערת לסרטון שצוין. יכול להיות שהבקשה לא אושרה כמו שצריך. |
forbidden (403) |
forbidden |
למשתמש שאומת אין הרשאות להעלות ולהגדיר תמונות ממוזערות מותאמות אישית של סרטונים. |
notFound (404) |
videoNotFound |
הסרטון שאתם מנסים להוסיף לו תמונה ממוזערת לא נמצא. צריך לבדוק את הערך של הפרמטר videoId בבקשה ולוודא שהוא נכון. |
tooManyRequests (429) |
uploadRateLimitExceeded |
הערוץ העלה יותר מדי תמונות ממוזערות לאחרונה. אפשר לנסות לשלוח את הבקשה שוב אחר כך. |
רוצה לנסות?
משתמשים ב-APIs Explorer כדי לשלוח קריאה ל-API הזה ולראות את בקשת ה-API והתגובה.