ChannelBanners
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une ressource channelBanner
contient l'URL que vous utiliserez pour définir une image nouvellement importée comme bannière d'une chaîne.
Méthodes
L'API prend en charge les méthodes suivantes pour les ressources channelBanners
:
- insérer
- Met en ligne une image de bannière de chaîne sur YouTube. Cette méthode représente les deux premières étapes d'un processus en trois étapes pour modifier l'image de la bannière d'une chaîne:
- Appelez la méthode
channelBanners.insert
pour mettre en ligne les données d'image binaires sur YouTube. L'image doit être au format 16:9 et mesurer au moins 2 048 x 1 152 pixels. Nous vous recommandons d'importer une image de 2 560 x 1 440 pixels. - Extrayez la valeur de la propriété
url
de la réponse renvoyée par l'API pour l'étape 1. - Appelez la méthode
channels.update
pour mettre à jour les paramètres de branding de la chaîne. Définissez la valeur de la propriété brandingSettings.image.bannerExternalUrl
sur l'URL obtenue à l'étape 2.
Représentation de la ressource
La structure JSON suivante montre le format d'une ressource channelBanners
:
{
"kind": "youtube#channelBannerResource",
"etag": etag,
"url": string
}
Propriétés
Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:
Propriétés |
kind |
string
Identifie le type de la ressource API. La valeur sera youtube#channelBannerResource . |
etag |
etag
Etag de cette ressource. |
url |
string
URL de l'image de la bannière. Après avoir appelé la méthode channelBanners.insert , extrayez cette valeur de la réponse de l'API. Appelez ensuite la méthode channels.update et définissez l'URL comme valeur de la propriété brandingSettings.image.bannerExternalUrl pour définir l'image de bannière d'une chaîne. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/12/21 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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"]]