ChannelBanners

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

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.