Thumbnails

منبع thumbnail اندازه‌های مختلف تصویر ریزعکس منسوب به یک منبع را شناسایی می‌کند. لطفاً به ویژگی‌های زیر برای تصاویر ریزعکس توجه کنید:

• ویژگی snippet.thumbnails یک منبع، شیئی است که تصاویر کوچک موجود برای آن منبع را شناسایی می‌کند.
• منبع thumbnail شامل مجموعه‌ای از اشیا است. نام هر شیء (default،‏ medium،‏ high، و غیره) به اندازه تصویر کوچک اشاره دارد.
• انواع مختلف منابع ممکن است از اندازه‌های مختلف تصویر کوچک پشتیبانی کنند.
• انواع مختلف منابع ممکن است اندازه‌های متفاوتی برای تصاویر ریزعکس با نام یکسان تعریف کنند. برای مثال، تصویر کوچک default برای منبع video معمولاً ۱۲۰ پیکسل در ۹۰ پیکسل است و تصویر کوچک default برای منبع channel معمولاً ۸۸ پیکسل در ۸۸ پیکسل است.
• منابع از یک نوع ممکن است همچنان اندازه‌های تصویر ریزعکس متفاوتی برای تصاویر خاص داشته باشند، بسته به وضوح تصویر اصلی یا محتوای بارگذاری‌شده در YouTube. برای مثال، یک ویدیو HD ممکن است از ریزعکس‌هایی با وضوح بالاتر نسبت به ویدیوهای غیر HD پشتیبانی کند.
• هر شیئی که حاوی اطلاعاتی درباره اندازه تصویر ریزعکس است، دارای یک دارایی width و یک دارایی height است. بااین‌حال، ممکن است ویژگی‌های عرض و ارتفاع برای آن تصویر برگردانده نشود.
• اگر تصویر کوچک بارگذاری‌شده با ابعاد موردنیاز مطابقت نداشته باشد، اندازه تصویر بدون تغییر نسبت ابعادی آن تغییر می‌کند تا با اندازه صحیح مطابقت داشته باشد. تصویر برش داده نشده است، اما ممکن است شامل نوارهای سیاه باشد تا اندازه آن درست باشد.

روش‌ها

این میانای برنامه‌سازی کاربردی از روش‌های زیر برای منابع 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 تصویر ریزعکس پیش‌فرض. ریزعکس پیش‌فرض برای یک ویدیو – یا منبعی که به یک ویدیو ارجاع می‌دهد، مانند یک مورد فهرست پخش یا نتیجه جستجو – ۱۲۰ پیکسل عرض و ۹۰ پیکسل ارتفاع دارد. ریزعکس پیش‌فرض برای یک کانال ۸۸ پیکسل عرض و ۸۸ پیکسل ارتفاع دارد.
default.url	string نشانی وب تصویر.
default.width	unsigned integer عرض تصویر.
default.height	unsigned integer ارتفاع تصویر.
medium	object نسخه با وضوح بالاتر از تصویر کوچک. برای ویدیو (یا منبعی که به ویدیو ارجاع می‌دهد)، این تصویر ۳۲۰ پیکسل عرض و ۱۸۰ پیکسل ارتفاع دارد. برای کانال، این تصویر ۲۴۰ پیکسل عرض و ۲۴۰ پیکسل ارتفاع دارد.
medium.url	string نشانی وب تصویر.
medium.width	unsigned integer عرض تصویر.
medium.height	unsigned integer ارتفاع تصویر.
high	object نسخه با وضوح بالای تصویر کوچک. برای ویدیو (یا منبعی که به ویدیو اشاره می‌کند)، این تصویر ۴۸۰ پیکسل عرض و ۳۶۰ پیکسل ارتفاع دارد. برای یک کانال، این تصویر ۸۰۰ پیکسل عرض و ۸۰۰ پیکسل ارتفاع دارد.
high.url	string نشانی وب تصویر.
high.width	unsigned integer عرض تصویر.
high.height	unsigned integer ارتفاع تصویر.
standard	object نسخه‌ای از تصویر کوچک با وضوح حتی بالاتر از تصویر با وضوح high. این تصویر برای برخی ویدیوها و منابع دیگری که به ویدیوها ارجاع می‌دهند، مانند موارد فهرست پخش یا نتایج جستجو، دردسترس است. این تصویر ۶۴۰ پیکسل عرض و ۴۸۰ پیکسل ارتفاع دارد.
standard.url	string نشانی وب تصویر.
standard.width	unsigned integer عرض تصویر.
standard.height	unsigned integer ارتفاع تصویر.
maxres	object نسخه با بالاترین وضوح تصویر ریزعکس. این اندازه تصویر برای برخی ویدیوها و منابع دیگری که به ویدیوها ارجاع می‌دهند، مانند موارد فهرست پخش یا نتایج جستجو، دردسترس است. این تصویر ۱۲۸۰ پیکسل عرض و ۷۲۰ پیکسل ارتفاع دارد.
maxres.url	string نشانی وب تصویر.
maxres.width	unsigned integer عرض تصویر.
maxres.height	unsigned integer ارتفاع تصویر.