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

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

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