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 recursovideo
es generalmente de 120 px por 90 px, y la imagen en miniaturadefault
para un recursochannel
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 propiedadheight
. 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. |