Thumbnails

Une ressource thumbnail identifie différentes tailles d'image de vignette 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.) correspond à la taille de l'image miniature.
• Chaque type de ressource accepte différentes tailles de vignettes.
• Différents types de ressources peuvent définir différentes tailles pour les vignettes 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 88 x 88 pixels.
• Des ressources du même type peuvent toujours avoir des tailles de miniature différentes pour certaines images, en fonction de la résolution de l'image d'origine ou du contenu mis en ligne sur YouTube. Par exemple, une vidéo HD peut être compatible avec des miniatures de meilleure résolution que les vidéos non HD.
• Chaque objet qui contient des informations sur la taille d'une vignette possède une propriété width et une propriété height. Toutefois, les propriétés de largeur et de hauteur ne peuvent pas être renvoyées pour cette image.
• Si une vignette importée ne correspond pas aux dimensions requises, elle est redimensionnée pour correspondre à la taille correcte sans modifier ses proportions. L'image n'est pas recadrée, mais des barres noires peuvent apparaître afin que la taille soit correcte.

Méthodes

L'API est compatible avec les méthodes suivantes pour les ressources thumbnails:

ensemble

Il met en ligne une miniature de vidéo personnalisée sur YouTube et la définit pour une 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 Vignette par défaut. La miniature par défaut d'une vidéo (ou d'une ressource faisant 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 fait 88 pixels de large et 88 pixels de haut.
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 de résolution supérieure de l'image miniature. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 320 pixels de large et 180 pixels de haut. Pour une chaîne, elle mesure 240 pixels de large et 240 pixels 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 l'image miniature. Pour une vidéo (ou une ressource faisant référence à une vidéo), cette image mesure 480 pixels de large et 360 pixels de haut. Pour une chaîne, elle mesure 800 pixels de large et 800 pixels de haut.
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 Une version de la miniature avec une résolution encore supérieure à celle de l'image high. Cette image est disponible pour certaines vidéos et d'autres ressources faisant référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image fait 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 l'image miniature. Cette taille d'image est disponible pour certaines vidéos et d'autres ressources faisant référence à des vidéos, comme des éléments de playlist ou des résultats de recherche. Cette image fait 1 280 pixels de large et 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.