ChannelBanners

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

Metodi

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

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

  1. Richiama il metodo channelBanners.insert per caricare i dati dell'immagine binaria su YouTube. L'immagine deve avere proporzioni 16:9 ed essere di almeno 2048 x 1152 pixel. Ti consigliamo di caricare un'immagine da 2560 x 1440 px.
  2. Estrai il valore della proprietà url dalla risposta restituita dall'API per il passaggio 1.
  3. Richiama il metodo channels.update per aggiornare le impostazioni di branding del canale. Imposta il valore della proprietà brandingSettings.image.bannerExternalUrl sull'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à 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. A questo punto, chiama il metodo channels.update e imposta l'URL come valore della proprietà brandingSettings.image.bannerExternalUrl per impostare l'immagine banner per un canale.