משאב thumbnail
מזהה גדלים שונים של תמונות ממוזערות המשויכות למשאב. שים לב למאפיינים הבאים של תמונות ממוזערות:
- המאפיין
snippet.thumbnails
של משאב הוא אובייקט שמזהה את התמונות הממוזערות שזמינות למשאב הזה. - משאב
thumbnail
מכיל סדרת אובייקטים. השם של כל אובייקט (default
,medium
,high
וכו') מתייחס לגודל התמונה הממוזערת. - סוגים שונים של משאבים עשויים לתמוך בתמונות ממוזערות בגדלים שונים.
- סוגים שונים של משאבים עשויים להגדיר גדלים שונים עבור תמונות ממוזערות עם אותו שם. לדוגמה,
default
התמונה הממוזערת של משאבvideo
היא בדרך כלל בגודל של 120 פיקסלים על 90 פיקסלים, וdefault
התמונה הממוזערת של משאבchannel
היא בדרך כלל בגודל 88 פיקסלים על 88 פיקסלים. - יכול להיות שבמשאבים מאותו סוג יופיעו תמונות ממוזערות בגדלים שונים, בהתאם לרזולוציה של התמונה המקורית או של התוכן שהעליתם ל-YouTube. לדוגמה: יכול להיות שסרטון באיכות HD תומך בתמונות ממוזערות ברזולוציה גבוהה יותר בהשוואה לסרטונים שאינם באיכות HD.
- לכל אובייקט שמכיל מידע על גודל של תמונה ממוזערת יש מאפיין
width
ומאפייןheight
. עם זאת, ייתכן שמאפייני הרוחב והגובה לא יוחזרו עבור תמונה זו. - אם התמונה הממוזערת שהועלתה לא תואמת למידות הנדרשות, הגודל של התמונה ישתנה בהתאם לגודל הנכון בלי לשנות את יחס הגובה-רוחב שלה. התמונה לא חתוכה, אבל ייתכן שהיא תכלול פסים שחורים כדי שהגודל יהיה נכון.
שיטות
ה-API תומך בשיטות הבאות למשאבים של thumbnails
:
- הגדרה
- מעלה תמונה ממוזערת מותאמת אישית של סרטון ל-YouTube ומגדיר אותה לסרטון.
ייצוג משאבים
מבנה ה-JSON הבא מציג את הפורמט של משאב thumbnails
:
{ "default": { "url": string, "width": unsigned integer, "height": unsigned integer }, "medium": { "url": string, "width": unsigned integer, "height": unsigned integer }, "high": { "url": string, "width": unsigned integer, "height": unsigned integer }, "standard": { "url": string, "width": unsigned integer, "height": unsigned integer }, "maxres": { "url": string, "width": unsigned integer, "height": unsigned integer } }
תכונות
הטבלה הבאה מגדירה את המאפיינים שיופיעו במשאב הזה:
תכונות | |
---|---|
default |
object ברירת המחדל לתמונה הממוזערת. התמונה הממוזערת המוגדרת כברירת מחדל של סרטון – או משאב שמפנה לסרטון, כמו פריט בפלייליסט או תוצאת חיפוש – היא ברוחב של 120 פיקסלים ובגובה של 90 פיקסלים. התמונה הממוזערת שמוגדרת כברירת מחדל לערוץ היא ברוחב 88 פיקסלים וגובה של 88 פיקסלים. |
default.url |
string כתובת ה-URL של התמונה. |
default.width |
unsigned integer רוחב התמונה. |
default.height |
unsigned integer גובה התמונה. |
medium |
object גרסה של התמונה הממוזערת ברזולוציה גבוהה יותר. לסרטון (או למקור מידע שמפנה לסרטון), רוחב התמונה הוא 320 פיקסלים וגובהה הוא 180 פיקסלים. כשמדובר בערוץ, התמונה הזו היא ברוחב של 240 פיקסלים ובגובה של 240 פיקסלים. |
medium.url |
string כתובת ה-URL של התמונה. |
medium.width |
unsigned integer רוחב התמונה. |
medium.height |
unsigned integer גובה התמונה. |
high |
object גרסה של התמונה הממוזערת ברזולוציה גבוהה. לסרטון (או משאב שמפנה לסרטון), רוחב התמונה הוא 480 פיקסלים וגובהה הוא 360 פיקסלים. כשמדובר בערוץ, התמונה הזו היא ברוחב של 800 פיקסלים ובגובה של 800 פיקסלים. |
high.url |
string כתובת ה-URL של התמונה. |
high.width |
unsigned integer רוחב התמונה. |
high.height |
unsigned integer גובה התמונה. |
standard |
object גרסה ברזולוציה גבוהה יותר של התמונה הממוזערת לעומת התמונה ברזולוציה high . התמונה הזו זמינה לסרטונים מסוימים ולמקורות מידע אחרים שקשורים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. רוחב התמונה הוא 640 פיקסלים וגובהה הוא 480 פיקסלים. |
standard.url |
string כתובת ה-URL של התמונה. |
standard.width |
unsigned integer רוחב התמונה. |
standard.height |
unsigned integer גובה התמונה. |
maxres |
object הגרסה של התמונה הממוזערת ברזולוציה הגבוהה ביותר. גודל התמונה הזה זמין לסרטונים מסוימים ולמשאבים אחרים שמתייחסים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. הרוחב של התמונה הזו הוא 1,280 פיקסלים וגובה של 720 פיקסלים. |
maxres.url |
string כתובת ה-URL של התמונה. |
maxres.width |
unsigned integer רוחב התמונה. |
maxres.height |
unsigned integer גובה התמונה. |