Zasób channelBanner
zawiera adres URL, którego użyjesz do ustawienia nowo przesłanego obrazu jako obrazu banera kanału.
Metody
Interfejs API obsługuje te metody dotyczące zasobów channelBanners
:
- insert
- Prześlij do YouTube obraz banera kanału. Ta metoda obejmuje 2 pierwsze kroki 3-etapowego procesu aktualizacji obrazu banera kanału:
- Aby przesłać binarne dane obrazu do YouTube, wywołaj metodę
channelBanners.insert
. Obraz musi mieć format 16:9 i rozmiar co najmniej 2048 x 1152 piksele. Zalecamy przesłanie obrazu o wymiarach 2560 × 1440 pikseli. - Wyodrębnij wartość właściwości
url
z odpowiedzi zwróconej przez interfejs API w kroku 1. - Aby zaktualizować ustawienia marki kanału, wywołaj metodę
channels.update
. Ustaw wartość właściwościbrandingSettings.image.bannerExternalUrl
na adres URL uzyskany w kroku 2.
- Aby przesłać binarne dane obrazu do YouTube, wywołaj metodę
Reprezentacja zasobu
Struktura JSON poniżej pokazuje format zasobu channelBanners
:
{ "kind": "youtube#channelBannerResource", "etag": etag, "url": string }
Właściwości
Właściwości występujące w tym zasobie są opisane w tabeli poniżej:
Właściwości | |
---|---|
kind |
string Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#channelBannerResource . |
etag |
etag Etag tego zasobu. |
url |
string Adres URL obrazu banera. Po wywołaniu metody channelBanners.insert wyodrębnij tę wartość z odpowiedzi interfejsu API. Następnie wywołaj metodę channels.update i ustaw adres URL jako wartość właściwości brandingSettings.image.bannerExternalUrl , aby ustawić obraz banera dla kanału. |