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
ارتفاع تصویر