ChannelBanners

Zasób channelBanner zawiera adres URL, za pomocą którego ustawisz nowo przesłany obraz jako obraz banera kanału.

Metody

Interfejs API obsługuje te metody zasobów channelBanners:

wstaw
Przesyła obraz banera kanału do YouTube. Poniższa metoda przedstawia pierwsze 2 etapy 3-etapowego procesu aktualizowania obrazu banera kanału:

  1. Wywołaj metodę channelBanners.insert, aby przesłać dane obrazu binarnego do YouTube. Obraz musi mieć format 16:9 i minimalny rozmiar 2048 x 1152 piksele. Zalecamy przesłanie obrazu o wymiarach 2560 x 1440 pikseli.
  2. Wyodrębnij wartość właściwości url z odpowiedzi, którą interfejs API zwraca w kroku 1.
  3. Wywołaj metodę channels.update, aby zaktualizować ustawienia marki kanału. Jako wartość właściwości brandingSettings.image.bannerExternalUrl ustaw adres URL uzyskany w kroku 2.

Reprezentacja zasobu

Poniższa struktura JSON pokazuje format zasobu channelBanners:

{
  "kind": "youtube#channelBannerResource",
  "etag": etag,
  "url": string
}

Właściwości

Poniższa tabela przedstawia właściwości, które pojawiają się w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartością będzie 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.