ChannelBanners

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

Methoden

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

insert
Lädt ein Kanalbanner auf YouTube hoch. Diese Methode stellt die ersten beiden Schritte eines dreistufigen Prozesses dar, mit denen das Bannerbild für einen Kanal aktualisiert wird:

  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 2.048 × 1.152 Pixel haben. Wir empfehlen, ein Bild mit einer Größe von 2560 × 1440 Pixel hochzuladen.
  2. Extrahieren Sie den Wert der url-Eigenschaft 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 des Attributs brandingSettings.image.bannerExternalUrl auf die URL fest, die Sie in Schritt 2 erhalten haben.

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
Das ist 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 Eigenschaft brandingSettings.image.bannerExternalUrl fest, um das Bannerbild für einen Kanal festzulegen.