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