ChannelBanners

Una risorsa channelBanner contiene l'URL che useresti per impostare un'immagine appena caricata come immagine banner di un canale.

Metodi

L'API supporta i seguenti metodi per le risorse di channelBanners:

inserire
Carica un'immagine del banner del canale su YouTube. Questo metodo rappresenta i primi due passaggi di un processo in tre passaggi per aggiornare l'immagine del banner di un canale:

  1. Chiama il metodo channelBanners.insert per caricare i dati dell'immagine binaria su YouTube. L'immagine deve avere proporzioni 16:9 ed essere almeno 2048 x 1152 pixel. Ti consigliamo di caricare un'immagine di 2560 x 1440 pixel.
  2. Estrai il valore della proprietà url dalla risposta restituita dall'API per il passaggio 1.
  3. Chiama il metodo channels.update per aggiornare le impostazioni di branding del canale. Imposta il valore della proprietà brandingSettings.image.bannerExternalUrl con l'URL ottenuto nel passaggio 2.

Rappresentazione delle risorse

La seguente struttura JSON mostra il formato di una risorsa channelBanners:

{
  "kind": "youtube#channelBannerResource",
  "etag": etag,
  "url": string
}

Proprietà

La tabella seguente definisce le proprietà che vengono visualizzate in questa risorsa:

Proprietà
kind string
Identifica il tipo di risorsa API. Il valore sarà youtube#channelBannerResource.
etag etag
L'Etag di questa risorsa.
url string
L'URL dell'immagine del banner. Dopo aver chiamato il metodo channelBanners.insert, estrai questo valore dalla risposta dell'API. Quindi chiama il metodo channels.update e imposta l'URL come valore della proprietà brandingSettings.image.bannerExternalUrl per impostare l'immagine banner di un canale.