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
  }
}

Характеристики

В следующей таблице определены свойства, которые появляются в этом ресурсе: