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.insertpour 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é
urlde la réponse renvoyée par l'API pour l'étape 1. - Appelez la méthode
channels.updatepour mettre à jour les paramètres de branding de la chaîne. Définissez la valeur de la propriétébrandingSettings.image.bannerExternalUrlsur l'URL obtenue à l'étape 2.
- Appelez la méthode
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 |
stringIdentifie le type de la ressource API. La valeur sera youtube#channelBannerResource. |
etag |
etagEtag de cette ressource. |
url |
stringURL 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. |