Wir aktualisieren die Data API, damit sie der Zählweise von YouTube-Aufrufen für Kurzvideos entspricht.
Weitere Informationen
ChannelBanners
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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:
- 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. - Extrahieren Sie den Wert des Attributs
url aus der Antwort, die die API für Schritt 1 zurückgibt. - 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. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-21 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-21 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003echannelBanner\u003c/code\u003e resource provides the URL needed to set a newly uploaded image as a channel's banner image.\u003c/p\u003e\n"],["\u003cp\u003eUpdating a channel banner image involves a three-step process, starting with uploading the image using the \u003ccode\u003echannelBanners.insert\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe uploaded banner image must have a 16:9 aspect ratio and be at least 2048x1152 pixels, with 2560x1440 recommended.\u003c/p\u003e\n"],["\u003cp\u003eAfter uploading, the \u003ccode\u003eurl\u003c/code\u003e property from the API response is extracted, and then used in the \u003ccode\u003echannels.update\u003c/code\u003e method, specifically in the \u003ccode\u003ebrandingSettings.image.bannerExternalUrl\u003c/code\u003e property, to set the banner image.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003echannelBanners\u003c/code\u003e resource contains \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, and \u003ccode\u003eurl\u003c/code\u003e properties, with the \u003ccode\u003eurl\u003c/code\u003e property holding the banner image's URL.\u003c/p\u003e\n"]]],["The `channelBanner` resource provides a URL for setting a channel's banner image. Updating a banner involves three steps: first, use `channelBanners.insert` to upload an image (16:9 aspect ratio, at least 2048x1152 pixels). Second, extract the `url` from the response. Third, use `channels.update`, setting `brandingSettings.image.bannerExternalUrl` to the extracted URL. The resource includes `kind` (`youtube#channelBannerResource`), `etag`, and the banner image's `url`.\n"],null,["# ChannelBanners\n\nA `channelBanner` resource contains the URL that you would use to set a newly uploaded image as the banner image for a channel.\n\nMethods\n-------\n\nThe API supports the following methods for `channelBanners` resources:\n\n[insert](/youtube/v3/docs/channelBanners/insert)\n: Uploads a channel banner image to YouTube. This method represents the first two steps in a three-step process to update the banner image for a channel:\n\n 1. Call the [channelBanners.insert](/youtube/v3/docs/channelBanners/insert) method to upload the binary image data to YouTube. The image must have a 16:9 aspect ratio and be at least 2048x1152 pixels. We recommend uploading a 2560px by 1440px image.\n 2. Extract the `url` property's value from the response that the API returns for step 1.\n 3. Call the [channels.update](/youtube/v3/docs/channels/update) method to update the channel's branding settings. Set the [brandingSettings.image.bannerExternalUrl](/youtube/v3/docs/channels#brandingSettings.image.bannerExternalUrl) property's value to the URL obtained in step 2.\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `channelBanners` resource: \n\n```text\n{\n \"kind\": \"youtube#channelBannerResource\",\n \"etag\": etag,\n \"url\": string\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#channelBannerResource`. |\n| `etag` | `etag` The Etag of this resource. |\n| `url` | `string` The banner image's URL. After calling the [channelBanners.insert](/youtube/v3/docs/channelBanners/insert) method, extract this value from the API response. Then call the [channels.update](/youtube/v3/docs/channels/update) method, and set the URL as the value of the [brandingSettings.image.bannerExternalUrl](/youtube/v3/docs/channels#brandingSettings.image.bannerExternalUrl) property to set the banner image for a channel. |"]]
