Thumbnails

Un recurso thumbnail identifica diferentes tamaños de imágenes en miniatura asociadas a un recurso. Ten en cuenta las siguientes características de las imágenes en miniatura:

  • Una propiedad snippet.thumbnails del recurso es un objeto que identifica las imágenes en miniatura disponibles para ese recurso.
  • Un recurso thumbnail contiene una serie de objetos. El nombre de cada objeto (default, medium, high, etc.) se refiere al tamaño de imágenes en miniatura.
  • Los diferentes tipos de recursos pueden soportar diferentes tamaños de imágenes en miniatura.
  • Los diferentes tipos de recursos pueden definir distintos tamaños de imágenes en miniatura con el mismo nombre. Por ejemplo, la imagen en miniatura default para un recurso video es generalmente de 120 px por 90 px, y la imagen en miniatura default para un recurso channel suele ser de 88 px por 88 px.
  • Es posible que los recursos del mismo tipo aún tengan tamaños de imágenes en miniatura diferentes para ciertas imágenes en función de la resolución de la imagen original o el contenido subido a YouTube. Por ejemplo, un video de alta definición puede admitir miniaturas de mayor resolución que los videos que no son de alta definición.
  • Cada objeto que contiene información sobre el tamaño de imágenes en miniatura tiene una propiedad width y una propiedad height. Sin embargo, es posible que las propiedades de anchura y altura no se muestren para esa imagen.
  • Si una imagen en miniatura cargada no coincide con las dimensiones requeridas, la imagen cambia de tamaño para que coincida con el tamaño correcto, sin cambiar la proporción. La imagen no se recorta, pero puede incluir barras de color negro para que el tamaño sea el correcto.

Métodos

La API admite los siguientes métodos para los recursos de thumbnails:

set
Carga una miniatura de video personalizada a YouTube y la configura para un video.

Representación de recursos

La estructura JSON a continuación muestra el formato de un recurso de 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
  }
}

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
default object
Imagen en miniatura predeterminada. La viñeta predeterminada de un video, o de un recurso que se refiere a un video, como un elemento de una lista de reproducción o el resultado de una búsqueda, es de 120 píxeles de ancho y 90 píxeles de alto. La viñeta predeterminada para un canal es de 88 píxeles de ancho y 88 píxeles de alto.
default.url string
URL de la imagen.
default.width unsigned integer
Ancho de la imagen.
default.height unsigned integer
Altura de la imagen.
medium object
Versión de mayor resolución de la imagen en miniatura. Para un video (o un recurso que hace referencia a un video), esta imagen es de 320 píxeles de ancho y 180 píxeles de alto. Para un canal, esta imagen es de 240 píxeles de ancho y 240 píxeles de alto.
medium.url string
URL de la imagen.
medium.width unsigned integer
Ancho de la imagen.
medium.height unsigned integer
Altura de la imagen.
high object
Versión de alta resolución de la imagen en miniatura. Para un video (o un recurso que hace referencia a un video), esta imagen es de 480 píxeles de ancho y 360 píxeles de alto. Para un canal, esta imagen es de 800 píxeles de ancho y 800 píxeles de alto.
high.url string
URL de la imagen.
high.width unsigned integer
Ancho de la imagen.
high.height unsigned integer
Altura de la imagen.