Una risorsa channelBanner
contiene l'URL da utilizzare per impostare un'immagine appena caricata come immagine del banner di un canale.
Metodi
L'API supporta i seguenti metodi per le risorse channelBanners
:
- insert
- Carica un'immagine del banner del canale su YouTube. Questo metodo rappresenta i primi due passaggi di una procedura in tre fasi per aggiornare l'immagine del banner di un canale:
- Chiama il metodo
channelBanners.insert
per caricare i dati delle immagini binarie su YouTube. L'immagine deve avere proporzioni 16:9 e essere di almeno 2048 x 1152 pixel. 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. - Chiama 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.
- 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à 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. Poi chiama il metodo channels.update e imposta l'URL come valore della proprietà brandingSettings.image.bannerExternalUrl per impostare l'immagine del banner di un canale. |