Une ressource thumbnail
identifie les différentes tailles d'images miniatures associées à une ressource. Veuillez noter les caractéristiques suivantes des vignettes:
- La propriété
snippet.thumbnails
d'une ressource est un objet qui identifie les vignettes disponibles pour cette ressource. - Une ressource
thumbnail
contient une série d'objets. Le nom de chaque objet (default
,medium
,high
, etc.) fait référence à la taille de la vignette. - Différents types de ressources peuvent accepter différentes tailles d'images miniatures.
- Différents types de ressources peuvent définir différentes tailles pour les vignettes portant le même nom. Par exemple, l'image miniature
default
d'une ressourcevideo
mesure généralement 120 x 90 pixels, tandis que l'image miniaturedefault
d'une ressourcechannel
mesure généralement 88 x 88 pixels. - Selon la résolution de l'image d'origine ou du contenu mis en ligne sur YouTube, les ressources du même type peuvent toujours avoir des tailles différentes pour certaines images. Par exemple, une vidéo HD peut être compatible avec des miniatures de résolution supérieure à celle des vidéos non HD.
- Chaque objet contenant des informations sur la taille de l'image miniature possède une propriété
width
et une propriétéheight
. Toutefois, il est possible que les propriétés de largeur et de hauteur ne soient pas renvoyées pour cette image. - Si les dimensions d'une vignette importée ne correspondent pas aux dimensions requises, l'image est redimensionnée afin de correspondre à la taille correcte sans modifier ses proportions. L'image n'est pas recadrée, mais peut inclure des barres noires pour que la taille soit correcte.
Méthodes
L'API accepte les méthodes suivantes pour les ressources thumbnails
:
- set
- Mettez en ligne une miniature de vidéo personnalisée sur YouTube et définissez-la comme vidéo.
Représentation des ressources
La structure JSON suivante montre le format d'une ressource 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 } }
Propriétés
Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:
Propriétés | |
---|---|
default |
object Image miniature par défaut. La miniature par défaut d'une vidéo, ou une ressource faisant référence à une vidéo, telle qu'un élément de playlist ou un résultat de recherche, fait 120 x 90 pixels de haut. La miniature par défaut d'une chaîne fait 88 x 88 pixels. |
default.url |
string URL de l'image. |
default.width |
unsigned integer Largeur de l'image. |
default.height |
unsigned integer Hauteur de l'image. |
medium |
object Version haute résolution de l'image miniature. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 320 x 180 pixels. Pour une chaîne, cette image fait 240 px de large et 240 px de haut. |
medium.url |
string URL de l'image. |
medium.width |
unsigned integer Largeur de l'image. |
medium.height |
unsigned integer Hauteur de l'image. |
high |
object Version haute résolution de la vignette. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 480 x 360 pixels. Pour une chaîne, cette image fait 800 x 800 pixels. |
high.url |
string URL de l'image. |
high.width |
unsigned integer Largeur de l'image. |
high.height |
unsigned integer Hauteur de l'image. |
standard |
object La résolution de la vignette est encore plus élevée que celle de high . Cette image est disponible pour certaines vidéos et autres ressources faisant référence à des vidéos, comme les playlists ou les résultats de recherche. Elle mesure 640 pixels de large et 480 pixels de haut. |
standard.url |
string URL de l'image. |
standard.width |
unsigned integer Largeur de l'image. |
standard.height |
unsigned integer Hauteur de l'image. |
maxres |
object Version avec la plus haute résolution de la vignette. Cette taille d'image est disponible pour certaines vidéos et autres ressources faisant référence à des vidéos, telles que des éléments de playlist ou des résultats de recherche. Elle mesure 1 280 pixels de large sur 720 pixels de haut. |
maxres.url |
string URL de l'image. |
maxres.width |
unsigned integer Largeur de l'image. |
maxres.height |
unsigned integer Hauteur de l'image. |