Une ressource channelBanner
contient l'URL que vous utiliseriez pour définir une nouvelle image importée comme image de bannière pour une chaîne.
Méthodes
L'API accepte les méthodes suivantes pour les ressources channelBanners
:
- insérer
- L'image de la bannière de la chaîne est mise en ligne sur YouTube. Cette méthode représente les deux premières étapes d'un processus en trois étapes visant à mettre à jour l'image de bannière d'une chaîne:
- Appelez la méthode
channelBanners.insert
pour importer les données de l'image binaire sur YouTube. L'image doit être au format 16:9 et faire 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 que l'API renvoie à 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.
- Appelez la méthode
Représentation des ressources
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 ressource de l'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 , puis définissez l'URL en tant que valeur de la propriété brandingSettings.image.bannerExternalUrl pour définir l'image de bannière d'un canal. |