ChannelBanners

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:

  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 faire 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 que l'API renvoie à 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 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.