Thumbnails

Eine thumbnail-Ressource gibt verschiedene Thumbnail-Bildgrößen an, die mit einer Ressource verknüpft sind. Beachten Sie die folgenden Eigenschaften von Vorschaubildern:

  • Die snippet.thumbnails-Property 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 jedes Objekts (default, medium, high usw.) bezieht sich auf die Größe des Vorschaubilds.
  • Für verschiedene Ressourcentypen werden möglicherweise unterschiedliche Thumbnail-Bildgrößen unterstützt.
  • Für verschiedene Ressourcentypen können unterschiedliche Größen für Vorschaubilder mit demselben Namen definiert werden. Die default-Miniaturansicht für eine video-Ressource hat beispielsweise in der Regel eine Größe von 120 × 90 Pixeln und die default-Miniaturansicht für eine channel-Ressource in der Regel eine Größe von 88 × 88 Pixeln.
  • Ressourcen desselben Typs können für bestimmte Bilder weiterhin unterschiedliche Miniaturansichtsgrößen haben, je nach Auflösung des Originalbilds oder der auf YouTube hochgeladenen Inhalte. So kann ein HD-Video beispielsweise Thumbnails mit einer höheren Auflösung unterstützen als Videos ohne HD-Qualität.
  • Jedes Objekt, das Informationen zu einer Miniaturbildgröße enthält, hat ein width-Attribut und ein height-Attribut. Die Eigenschaften für Breite und Höhe werden für dieses Bild jedoch möglicherweise nicht zurückgegeben.
  • Wenn ein hochgeladenes Thumbnail nicht die erforderlichen Abmessungen hat, wird die Größe des Bildes angepasst, ohne dass sich das Seitenverhältnis ändert. Das Bild ist nicht zugeschnitten, kann aber schwarze Balken enthalten, damit die Größe stimmt.

Methoden

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

set
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 enthalten sind:

Attribute
default object
Das Standardbild für die Miniaturansicht. Die Standard-Miniaturansicht für ein Video oder eine Ressource, die auf ein Video verweist, z. B. ein Playlistenelement oder ein Suchergebnis, ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Channel 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 Thumbnail-Bilds mit höherer Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Für einen Kanal ist dieses Bild 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 Thumbnail-Bilds mit hoher Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Für einen Kanal ist dieses Bild 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
Eine noch höher aufgelöste Version des Thumbnail-Bilds als das Bild mit high-Auflösung. 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 Vorschaubilds mit der höchsten Auflösung. Diese Bildgröße ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. 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.