ChannelBanners

Eine channelBanner-Ressource enthält die URL, mit der du ein neu hochgeladenes Bild als Bannerbild für einen Kanal festlegen kannst.

Methoden

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

insert
Ladet ein Kanalbannerbild auf YouTube hoch. Diese Methode umfasst die ersten beiden Schritte eines dreistufigen Vorgangs zum Aktualisieren des Bannerbilds für einen Kanal:
  1. Rufe die Methode channelBanners.insert auf, um die binären Bilddaten auf YouTube hochzuladen. Das Bild muss ein Seitenverhältnis von 16:9 und mindestens 2.048 × 1.152 Pixel haben. Wir empfehlen, ein Bild mit einer Größe von 2.560 × 1.440 Pixel hochzuladen.
  2. Extrahieren Sie den Wert des Attributs url aus der Antwort, die die API für Schritt 1 zurückgibt.
  3. Rufe die Methode channels.update auf, um die Branding-Einstellungen des Kanals zu aktualisieren. Legen Sie den Wert der Property brandingSettings.image.bannerExternalUrl auf die in Schritt 2 ermittelte URL fest.

Ressourcendarstellung

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

{
  "kind": "youtube#channelBannerResource",
  "etag": etag,
  "url": string
}

Attribute

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

Attribute
kind string
Identifiziert den Typ der API-Ressource. Der Wert ist youtube#channelBannerResource.
etag etag
Das Etag dieser Ressource.
url string
Die URL des Bannerbilds. Extrahieren Sie diesen Wert nach dem Aufruf der channelBanners.insert-Methode aus der API-Antwort. Rufe dann die Methode channels.update auf und setze die URL als Wert der Eigenschaft brandingSettings.image.bannerExternalUrl, um das Bannerbild für einen Kanal festzulegen.