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:
- 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. - Estrai il valore della proprietà
url
dalla risposta restituita dall'API per il passaggio 1. - 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.
- Chiama il metodo
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. |