Thumbnails

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

  • La propiedad snippet.thumbnails de un 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étera) hace referencia al tamaño de la imagen 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 de un recurso video suele ser de 120 px por 90 px, y la imagen en miniatura default de 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 una imagen 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 thumbnails:

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

Representación de recursos

En la siguiente estructura JSON, se muestra el formato de un recurso 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
  }
}

Propiedades

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

Propiedades
default object
Es la 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
Es la URL de la imagen.
default.width unsigned integer
Ancho de la imagen.
default.height unsigned integer
Altura de la imagen.
medium object
Es una 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
Es la URL de la imagen.
medium.width unsigned integer
Ancho de la imagen.
medium.height unsigned integer
Altura de la imagen.
high object
Es una 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
Es la URL de la imagen.
high.width unsigned integer
Ancho de la imagen.
high.height unsigned integer
Altura de la imagen.
standard object
Es una versión de la imagen en miniatura con una resolución aún mayor que la de la imagen en resolución high. Esta imagen está disponible para algunos videos y otros recursos que hacen referencia a videos, como los elementos de playlists o los resultados de la búsqueda. Esta imagen tiene 640 px de ancho y 480 px de alto.
standard.url string
Es la URL de la imagen.
standard.width unsigned integer
Ancho de la imagen.
standard.height unsigned integer
Altura de la imagen.
maxres object
Es la versión de mayor resolución de la imagen en miniatura. Este tamaño de imagen está disponible para algunos videos y otros recursos que hacen referencia a videos, como elementos de playlists o resultados de búsqueda. Esta imagen tiene 1,280 px de ancho y 720 px de alto.
maxres.url string
Es la URL de la imagen.
maxres.width unsigned integer
Ancho de la imagen.
maxres.height unsigned integer
Altura de la imagen.