Thumbnails

משאב 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
גובה התמונה.