ChannelBanners

Une ressource channelBanner contient l'URL que vous devez utiliser pour définir une nouvelle image en tant qu'image de bannière de votre chaîne.

Méthodes

L'API est compatible avec les méthodes suivantes pour les ressources channelBanners:

insérer
Il importe l'image de la bannière de la chaîne sur YouTube. Cette méthode représente les deux premières étapes d'un processus en trois étapes visant à mettre à jour l'image de la bannière d'une chaîne:

  1. 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 mesurer au moins 2 048 x 1 152 pixels. Nous vous recommandons d'importer une image de 2 560 x 1 440 pixels.
  2. Extrayez la valeur de la propriété url de la réponse renvoyée par l'API à l'étape 1.
  3. 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 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 d'API. La valeur est 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 comme valeur de la propriété brandingSettings.image.bannerExternalUrl pour définir l'image de la bannière d'une chaîne.