ChannelBanners

Zasób channelBanner zawiera adres URL, którego można użyć do ustawienia nowo przesłanego obrazu jako banera kanału.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów channelBanners:

wstaw
Przesyła obraz banera kanału do YouTube. Ta metoda pozwala wykonać 2 pierwsze kroki, które pozwolą zaktualizować obraz banera kanału:

  1. Wywołaj metodę channelBanners.insert, aby przesłać dane obrazu binarnego do YouTube. Obraz musi mieć współczynnik proporcji 16:9 i wymiary co najmniej 2048 x 1152 piksele. Zalecamy przesyłanie obrazu o wymiarach 2560 na 1440 pikseli.
  2. Wyodrębnij wartość właściwości url z odpowiedzi zwróconej przez interfejs API w kroku 1.
  3. Wywołaj metodę channels.update, aby zaktualizować ustawienia marki kanału. Ustaw wartość właściwości brandingSettings.image.bannerExternalUrl na adres URL uzyskany w kroku 2.

Reprezentowanie zasobów

Poniższa struktura JSON pokazuje format zasobu channelBanners:

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

Usługi

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

Usługi
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#channelBannerResource.
etag etag
Otagowanie 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, by ustawić obraz banera kanału.