ChannelBanners

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

Methoden

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

Einfügen

Laden Sie ein Kanalbanner auf YouTube hoch. Diese Methode stellt die ersten beiden Schritte der drei Schritte zur Aktualisierung des Bannerbilds für einen Kanal dar:

1. Rufen Sie die Methode channelBanners.insert auf, um die Binärbilddaten auf YouTube hochzuladen. Das Bild muss ein Seitenverhältnis von 16:9 und mindestens 2048 x 1152 Pixel haben. Wir empfehlen, ein Bild mit 2560 x 1440 Pixeln 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. Setzen Sie den Wert der brandingSettings.image.bannerExternalUrl-Property auf die in Schritt 2 abgerufene URL.

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 Attribute 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 Aufrufen der Methode channelBanners.insert aus der API-Antwort. Rufen Sie dann die Methode channels.update auf und legen Sie die URL als Wert der Property brandingSettings.image.bannerExternalUrl fest, um das Bannerbild für einen Kanal festzulegen.