Thumbnails

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

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

مواد و روش ها

API از روش های زیر برای منابع thumbnails پشتیبانی می کند:

set

یک تصویر کوچک ویدیوی سفارشی را در 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 ارتفاع تصویر