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
urlz 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.bannerExternalUrlna 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 |
stringOkreśla typ zasobu interfejsu API. Wartość będzie wynosić youtube#channelBannerResource. |
etag |
etagEtag tego zasobu. |
url |
stringAdres 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. |