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: 2024-12-21 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2024-12-21 (UTC)."],[[["The `channelBanner` resource provides the URL needed to set a newly uploaded image as a channel's banner image."],["Updating a channel banner image involves a three-step process, starting with uploading the image using the `channelBanners.insert` method."],["The uploaded banner image must have a 16:9 aspect ratio and be at least 2048x1152 pixels, with 2560x1440 recommended."],["After uploading, the `url` property from the API response is extracted, and then used in the `channels.update` method, specifically in the `brandingSettings.image.bannerExternalUrl` property, to set the banner image."],["The `channelBanners` resource contains `kind`, `etag`, and `url` properties, with the `url` property holding the banner image's URL."]]],["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"]]
