Thumbnails

Ресурс thumbnail определяет разные размеры значков, связанные с ресурсом. Обратите внимание на следующие характеристики значков:

• Свойство snippet.thumbnails ресурса – это объект, который идентифицирует значки, доступные для этого ресурса.
• Ресурс thumbnail содержит ряд объектов. Название каждого объекта (default, medium, high и т. д.) указывает на размер значка.
• Для разных типов ресурсов могут поддерживаться разные размеры значков.
• Для значков с одинаковым названием в разных типах ресурсов могут быть заданы разные размеры. Например, значок default для ресурса video обычно имеет размер 120 x 90 пикселей, а значок default для ресурса channel – 88 x 88 пикселей.
• Размеры значков для ресурсов одного типа могут различаться в зависимости от разрешения исходного изображения или контента, загруженного на YouTube. Например, для 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 x 88 пикселей.
default.url	string URL изображения.
default.width	unsigned integer Ширина изображения.
default.height	unsigned integer Высота изображения.
medium	object Версия значка с более высоким разрешением. Для видео (или ресурса, который ссылается на видео) это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала размер изображения составляет 240 x 240 пикселей.
medium.url	string URL изображения.
medium.width	unsigned integer Ширина изображения.
medium.height	unsigned integer Высота изображения.
high	object Значок с высоким разрешением. Для видео (или ресурса, который ссылается на видео) это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала это изображение размером 800 x 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 Высота изображения.