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.
Questo metodo supporta il caricamento di contenuti multimediali. I file caricati devono rispettare questi vincoli:
- Dimensioni massime del file:6 MB
- Tipi MIME multimediali accettati:
image/jpeg
,image/png
,application/octet-stream
Impatto sulla quota: una chiamata a questo metodo ha un costo della quota di 50 unità.
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti. Per scoprire di più sull'autenticazione e sull'autorizzazione, consulta Implementazione dell'autorizzazione OAuth 2.0.
Ambito |
---|
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parametri
La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.
Parametri | ||
---|---|---|
Parametri facoltativi | ||
onBehalfOfContentOwner |
string Questo parametro può essere utilizzato solo in una richiesta autorizzata. Nota: questo parametro è destinato esclusivamente ai partner di contenuti di YouTube. Il parametro onBehalfOfContentOwner indica che le credenziali di autorizzazione della richiesta identificano un utente di YouTube CMS che agisce per conto del proprietario dei contenuti specificato nel valore del parametro. Questo parametro è destinato ai partner di contenuti di YouTube che possiedono e gestiscono molti canali YouTube diversi. Consente ai proprietari di contenuti di autenticarsi una volta sola per accedere a tutti i dati dei video e dei canali, senza dover fornire le credenziali di autenticazione per ogni singolo canale. L'account CMS con cui l'utente esegue l'autenticazione deve essere collegato al proprietario dei contenuti di YouTube specificato. |
Corpo della richiesta
Non fornire un corpo della richiesta quando chiami questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa channelBanner
nel corpo della risposta.
Errori
La seguente tabella identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per maggiori dettagli, consulta la pagina API YouTube Data - Errori.
Tipo di errore | Dettaglio errore | Descrizione |
---|---|---|
badRequest (400) |
bannerAlbumFull |
L'album della grafica del canale YouTube contiene troppe immagini. Per risolvere il problema, vai a Google Foto, poi vai alla pagina degli album e rimuovi alcune immagini dall'album. |
badRequest (400) |
mediaBodyRequired |
La richiesta non include i contenuti dell'immagine. |
Prova
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.