Thumbnails

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

• Свойство snippet.thumbnails ресурса — это объект, который идентифицирует миниатюрные изображения, доступные для этого ресурса.
• Ресурс thumbnail содержит ряд объектов. Имя каждого объекта ( default , medium , high и т. д.) соответствует размеру изображения миниатюры.
• Различные типы ресурсов могут поддерживать различные размеры миниатюрных изображений.
• Разные типы ресурсов могут определять разные размеры миниатюр с одинаковым именем. Например, миниатюра default для video обычно имеет размер 120x90 пикселей, а миниатюра default для ресурса channel — 88x88 пикселей.
• Ресурсы одного типа могут иметь разные размеры миниатюр для некоторых изображений в зависимости от разрешения исходного изображения или контента, загруженного на 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
  }
}

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

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