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 пикселей и высоту 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
Высота изображения.