Thumbnails

Un recurso thumbnail identifica diferentes tamaños de imágenes en miniatura asociados con 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.) se refiere 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 para un recurso video suele ser 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 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:

configurar
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
La URL de la imagen.
default.width unsigned integer
El ancho de la imagen.
default.height unsigned integer
La 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
La URL de la imagen.
medium.width unsigned integer
El ancho de la imagen.
medium.height unsigned integer
La 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
La URL de la imagen.
high.width unsigned integer
El ancho de la imagen.
high.height unsigned integer
La altura de la imagen.
standard object
Una versión de la imagen en miniatura con una resolución aún mayor que la de la imagen con resolución high. Esta imagen está disponible para algunos videos y otros recursos que hacen referencia a videos, como elementos de listas de reproducción o resultados de búsqueda. Esta imagen es de 640 píxeles de ancho y 480 píxeles de alto.
standard.url string
La URL de la imagen.
standard.width unsigned integer
El ancho de la imagen.
standard.height unsigned integer
La altura de la imagen.
maxres object
La versión con la resolución más alta 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 listas de reproducción o resultados de búsqueda. Esta imagen es de 1280 píxeles de ancho y 720 píxeles de alto.
maxres.url string
La URL de la imagen.
maxres.width unsigned integer
El ancho de la imagen.
maxres.height unsigned integer
La altura de la imagen.