Thumbnails

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 ressource video mesure généralement 120 x 90 pixels, tandis que l'image miniature default d'une ressource channel 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.