מעלה תמונה ממוזערת מותאמת אישית של סרטון ל-YouTube ומגדיר אותה עבור סרטון.
השיטה הזו תומכת בהעלאת מדיה. הקבצים המועלים חייבים לעמוד במגבלות הבאות:
- גודל הקובץ המקסימלי: 2MB
- סוגי MIME מקובלים של מדיה:
image/jpeg,image/png,application/octet-stream
השפעת המכסה: קריאה לשיטה הזו כרוכה בעלות המכסה של כ-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.
תשובה
אם הפעולה בוצעה בהצלחה, השיטה הזו מחזירה גוף תגובה עם המבנה הבא:
{
"kind": "youtube#thumbnailSetResponse",
"etag": etag,
"items": [
thumbnail resource
]
}
תכונות
הטבלה הבאה מגדירה את המאפיינים שיופיעו במשאב הזה:
| תכונות | |
|---|---|
kind |
stringמזהה את הסוג של משאב ה-API. הערך יהיה youtube#thumbnailSetResponse. |
etag |
etagה-e של המשאב הזה. |
items[] |
listרשימה של תמונות ממוזערות. |
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שה-API עלול להחזיר בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במסמכים בנושא הודעת שגיאה.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
badRequest (400) |
invalidImage |
תוכן התמונה שסיפקת לא חוקי. |
badRequest (400) |
mediaBodyRequired |
הבקשה אינה כוללת את תוכן התמונה. |
forbidden (403) |
forbidden |
לא ניתן להגדיר את התמונה הממוזערת לסרטון שצוין. יכול להיות שהבקשה לא מורשית כמו שצריך. |
forbidden (403) |
forbidden |
למשתמש שאומת אין הרשאות להעלות סרטונים ולהגדיר להם תמונות ממוזערות מותאמות אישית. |
notFound (404) |
videoNotFound |
הסרטון שניסית להוסיף לו תמונה ממוזערת לא נמצא. צריך לבדוק את ערך הפרמטר videoId של הבקשה כדי לוודא שהוא נכון. |
tooManyRequests (429) |
uploadRateLimitExceeded |
הערוץ העלה יותר מדי תמונות ממוזערות לאחרונה. אפשר לנסות לשלוח את הבקשה שוב מאוחר יותר. |
רוצה לנסות?
משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה והתגובה של ה-API.