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:

  • 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.) 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 tener 120 px por 90 px, y la imagen en miniatura default de un recurso channel suele tener 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:

establecer
Sube una miniatura de video personalizada a YouTube y la establece para un video.

Representación de recursos

La siguiente estructura JSON 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
Es 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
Es la URL de la imagen.
medium.width unsigned integer
Ancho de la imagen
medium.height unsigned integer
Es 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
Es la URL de la imagen.
high.width unsigned integer
Ancho de la imagen
high.height unsigned integer
Es la altura de la imagen.
standard object
Una versión de la imagen en miniatura aún más alta que la imagen en 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
Es la URL de la imagen.
standard.width unsigned integer
Ancho de la imagen
standard.height unsigned integer
Es la altura de la imagen.
maxres object
La versión de la resolución más alta de la imagen en miniatura. El tamaño de 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 1280 píxeles de ancho y 720 píxeles de alto.
maxres.url string
Es la URL de la imagen.
maxres.width unsigned integer
Ancho de la imagen
maxres.height unsigned integer
Es la altura de la imagen.