Thumbnails

Une ressource thumbnail identifie les différentes tailles de vignettes associées à une ressource. Veuillez noter les caractéristiques suivantes des miniatures :

  • 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 l'image miniature.
  • Différents types de ressources peuvent être compatibles avec différentes tailles de miniatures.
  • Différents types de ressources peuvent définir différentes tailles pour les miniatures portant le même nom. Par exemple, la vignette default d'une ressource video mesure généralement 120 x 90 pixels, tandis que la vignette default d'une ressource channel mesure généralement 88 x 88 pixels.
  • Les ressources du même type peuvent toujours avoir des tailles d'images miniatures différentes pour certaines images, en fonction de la résolution de l'image ou du contenu d'origine importé sur YouTube. Par exemple, une vidéo HD peut être associée à des miniatures de résolution supérieure à celles des vidéos non HD.
  • Chaque objet contenant des informations sur la taille d'une miniature comporte une propriété width et une propriété height. Toutefois, les propriétés de largeur et de hauteur peuvent ne pas être renvoyées pour cette image.
  • Si une miniature importée ne correspond pas aux dimensions requises, elle est redimensionnée pour atteindre la taille appropriée sans que ses proportions soient modifiées. 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
Met en ligne une miniature vidéo personnalisée sur YouTube et la définit pour une vidéo.

Représentation de la ressource

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 vignette par défaut d'une vidéo (ou d'une ressource qui fait référence à une vidéo, comme un élément de playlist ou un résultat de recherche) mesure 120 pixels de large et 90 pixels de haut. La miniature par défaut d'une chaîne mesure 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 la miniature. Pour une vidéo (ou une ressource qui fait référence à une vidéo), cette image mesure 320 px de large et 180 px de haut. Pour une chaîne, cette image doit mesurer 240 x 240 pixels.
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 miniature. Pour une vidéo (ou une ressource qui fait référence à une vidéo), cette image mesure 480 px de large et 360 px de haut. Pour une chaîne, cette image doit avoir une largeur et une hauteur de 800 px.
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
Version de la miniature avec une résolution encore plus élevée que celle de l'image high. Cette image est disponible pour certaines vidéos et d'autres ressources qui font référence à des vidéos, comme les éléments de playlist ou les résultats de recherche. Cette image 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 de la miniature avec la résolution la plus élevée. Cette taille d'image est disponible pour certaines vidéos et d'autres ressources qui font référence à des vidéos, comme les éléments de playlist ou les résultats de recherche. Cette image mesure 1 280 px de large et 720 px 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.