Thumbnails

משאב thumbnail מזהה גדלים שונים של תמונות ממוזערות המשויכות למשאב. יש לשים לב למאפיינים הבאים של תמונות ממוזערות:

• מאפיין snippet.thumbnails של משאב הוא אובייקט שמזהה את התמונות הממוזערות הזמינות למשאב זה.
• משאב thumbnail מכיל סדרה של אובייקטים. השם של כל אובייקט (default, medium, high וכו') מתייחס לגודל התמונה הממוזערת.
• סוגים שונים של משאבים עשויים לתמוך בתמונות ממוזערות בגדלים שונים.
• לסוגים שונים של משאבים יכולים להיות גדלים שונים עבור תמונות ממוזערות בעלות אותו שם. לדוגמה, התמונה הממוזערת של default של משאב video היא בדרך כלל 120px על 90px, ותמונה ממוזערת של default למשאב channel היא בדרך כלל 88px על 88px.
• יכול להיות שמשאבים מאותו סוג עדיין יהיו בגדלים שונים של תמונות ממוזערות, בהתאם לרזולוציה של התמונה המקורית או התוכן שהעליתם ל-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 הגרסה ברזולוציה הגבוהה ביותר של התמונה הממוזערת. גודל תמונה זה זמין לסרטונים מסוימים ולמשאבים אחרים הקשורים לסרטונים, כגון פריטים בפלייליסט או תוצאות חיפוש. התמונה ברוחב 1280 פיקסלים ובגובה 720 פיקסלים.
maxres.url	string כתובת ה-URL של התמונה.
maxres.width	unsigned integer רוחב התמונה.
maxres.height	unsigned integer גובה התמונה.