Thumbnails

Eine thumbnail-Ressource gibt unterschiedliche Größen der Miniaturansichtbilder an, die mit einer Ressource verknüpft sind. Beachten Sie die folgenden Eigenschaften von Miniaturansichten:

  • Die Eigenschaft snippet.thumbnails einer Ressource ist ein Objekt, das die für diese Ressource verfügbaren Miniaturansichten identifiziert.
  • Eine Ressource vom Typ thumbnail enthält eine Reihe von Objekten. Der Name der einzelnen Objekte (default, medium, high usw.) bezieht sich auf die Größe der Miniaturansicht.
  • Unterschiedliche Ressourcentypen unterstützen möglicherweise verschiedene Miniaturansichten.
  • Für Miniaturansichten mit demselben Namen können unterschiedliche Ressourcentypen unterschiedlich groß sein. Das Thumbnail-Bild default für eine Ressource vom Typ video ist beispielsweise normalerweise 120 x 90 Pixel groß und das Thumbnail-Bild von default für eine Ressource vom Typ channel normalerweise 88 x 88 Pixel.
  • Ressourcen desselben Typs können für bestimmte Bilder je nach Auflösung des Originalbilds oder der auf YouTube hochgeladenen Inhalte unterschiedliche Miniaturansichten haben. Ein HD-Video unterstützt beispielsweise Miniaturansichten mit einer höheren Auflösung als Videos, die nicht in HD vorliegen.
  • Jedes Objekt, das Informationen über die Größe der Miniaturansicht enthält, hat eine width- und eine height-Property. Die Eigenschaften für Breite und Höhe können für das Bild jedoch nicht zurückgegeben werden.
  • Wenn ein hochgeladenes Thumbnail nicht die erforderlichen Abmessungen hat, wird seine Größe an die richtige Größe angepasst, ohne das Seitenverhältnis zu ändern. Das Bild ist nicht zugeschnitten, kann aber schwarze Balken enthalten, damit die Größe korrekt ist.

Methoden

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

Festlegen
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 Bild-URL.
default.width unsigned integer
Die Breite des Bildes.
default.height unsigned integer
Die Höhe des Bildes.
medium object
Eine Version der Miniaturansicht mit einer höheren Auflösung. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Bei einem Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch.
medium.url string
Die Bild-URL.
medium.width unsigned integer
Die Breite des Bildes.
medium.height unsigned integer
Die Höhe des Bildes.
high object
Eine hochauflösende Version der Miniaturansicht. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Bei einem Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch.
high.url string
Die Bild-URL.
high.width unsigned integer
Die Breite des Bildes.
high.height unsigned integer
Die Höhe des Bildes.
standard object
Eine noch höhere Auflösung der Miniaturansicht als das Bild der Auflösung 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 Bild-URL.
standard.width unsigned integer
Die Breite des Bildes.
standard.height unsigned integer
Die Höhe des Bildes.
maxres object
Die Version mit der höchsten Auflösung der Miniaturansicht. 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 Bild-URL.
maxres.width unsigned integer
Die Breite des Bildes.
maxres.height unsigned integer
Die Höhe des Bildes.