Thumbnails

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

  • המאפיין snippet.thumbnails של משאב הוא אובייקט שמזהה את התמונות הממוזערות שזמינות למשאב הזה.
  • משאב thumbnail מכיל סדרה של אובייקטים. השם של כל אובייקט (default,‏ medium,‏ high וכו') מתייחס לגודל התמונה הממוזערת.
  • יכול להיות שסוגים שונים של נכסים יתמכו בגדלים שונים של תמונות ממוזערות.
  • יכול להיות שסוגים שונים של משאבים יגדירו גדלים שונים לתמונות ממוזערות עם אותו שם. לדוגמה, התמונה הממוזערת default של משאב video היא בדרך כלל ברוחב 120 פיקסלים ובגובה 90 פיקסלים, והתמונה הממוזערת default של משאב channel היא בדרך כלל ברוחב 88 פיקסלים ובגובה 88 פיקסלים.
  • יכול להיות שלתמונות מסוימות יהיו גדלים שונים של תמונות ממוזערות, בהתאם לרזולוציה של התמונה המקורית או של התוכן שהועלה ל-YouTube. לדוגמה, יכול להיות שסרטון באיכות HD יתמוך בתמונות ממוזערות ברזולוציה גבוהה יותר מאשר סרטונים שלא באיכות HD.
  • לכל אובייקט שמכיל מידע על גודל תמונה ממוזערת יש מאפיין width ומאפיין height. עם זאת, יכול להיות שהמאפיינים של הרוחב והגובה לא יוחזרו עבור התמונה הזו.
  • אם תמונה ממוזערת שהועלתה לא תואמת למידות הנדרשות, המערכת משנה את הגודל של התמונה כך שתתאים לגודל הנכון בלי לשנות את יחס הגובה-רוחב שלה. התמונה לא נחתכת, אבל יכול להיות שיופיעו בה פסים שחורים כדי שהגודל יהיה נכון.

Methods

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