Thumbnails

Eine thumbnail-Ressource identifiziert verschiedene Miniaturansichtsgrößen, die mit einer Ressource verknüpft sind. Miniaturansichten:

  • Das Attribut snippet.thumbnails einer Ressource ist ein Objekt, das die für diese Ressource verfügbaren Miniaturansichten identifiziert.
  • Eine thumbnail-Ressource enthält eine Reihe von Objekten. Der Name der einzelnen Objekte (default, medium, high usw.) bezieht sich auf die Größe des Thumbnail-Bilds.
  • Verschiedene Arten von Ressourcen unterstützen möglicherweise unterschiedliche Größen von Miniaturansichten.
  • Verschiedene Arten von Ressourcen können unterschiedliche Größen für Miniaturansichten mit demselben Namen definieren. Beispiel: Das Thumbnail-Bild default für eine video-Ressource ist normalerweise 120 x 90 Pixel groß und das default-Thumbnail-Bild für eine channel-Ressource normalerweise 88 x 88 Pixel.
  • Ressourcen desselben Typs können für bestimmte Bilder immer noch unterschiedliche Miniaturansichtengrößen haben. Dies hängt von der Auflösung des Originalbilds oder des auf YouTube hochgeladenen Contents ab. So können beispielsweise bei einem HD-Video Miniaturansichten mit höherer Auflösung als bei anderen Videos unterstützt werden.
  • Jedes Objekt, das Informationen zur Größe des Miniaturbilds enthält, hat eine width-Eigenschaft und eine height-Eigenschaft. Die Eigenschaften für Breite und Höhe werden für dieses Bild jedoch möglicherweise nicht zurückgegeben.
  • Hat ein hochgeladenes Thumbnail-Bild nicht die erforderlichen Abmessungen, wird es auf die richtige Größe verkleinert, ohne dass sich das Seitenverhältnis ändert. Das Bild ist nicht zugeschnitten, kann aber schwarze Balken enthalten, damit die Größe richtig ist.

Methoden

Die API unterstützt die folgenden Methoden für thumbnails-Ressourcen:

fest
Lädt ein benutzerdefiniertes Video-Thumbnail auf YouTube hoch und legt es für ein Video fest.

Ressourcendarstellung

Die folgende JSON-Struktur zeigt das Format einer thumbnails-Ressource:

{
  "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
  }
}

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:

Attribute
default object
Das Standard-Thumbnail. Das Standard-Thumbnail für ein Video – oder eine Ressource, die auf ein Video verweist, z. B. ein Playlist-Element oder ein Suchergebnis – ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Kanal ist 88 Pixel breit und 88 Pixel hoch.
default.url string
Die URL des Bildes.
default.width unsigned integer
Die Breite des Bildes.
default.height unsigned integer
Die Höhe des Bildes.
medium object
Eine Version des Thumbnails mit höherer Auflösung. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Dieses Bild eines Kanals ist 240 Pixel breit und 240 Pixel hoch.
medium.url string
Die URL des Bildes.
medium.width unsigned integer
Die Breite des Bildes.
medium.height unsigned integer
Die Höhe des Bildes.
high object
Eine Version des Thumbnails mit hoher Auflösung. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Dieses Bild eines Kanals ist 800 Pixel breit und 800 Pixel hoch.
high.url string
Die URL des Bildes.
high.width unsigned integer
Die Breite des Bildes.
high.height unsigned integer
Die Höhe des Bildes.
standard object
Das Thumbnail ist in einer höheren Auflösung als das Bild mit einer Auflösung von high. Dieses Bild ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 640 Pixel breit und 480 Pixel hoch.
standard.url string
Die URL des Bildes.
standard.width unsigned integer
Die Breite des Bildes.
standard.height unsigned integer
Die Höhe des Bildes.
maxres object
Die Version des Thumbnails mit der höchsten Auflösung. Diese Bildgröße ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, wie Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 1.280 Pixel breit und 720 Pixel hoch.
maxres.url string
Die URL des Bildes.
maxres.width unsigned integer
Die Breite des Bildes.
maxres.height unsigned integer
Die Höhe des Bildes.