ChannelBanners: insert

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.

Ta metoda obsługuje przesyłanie multimediów. Przesłane pliki muszą być zgodne z tymi ograniczeniami:

  • Maksymalny rozmiar pliku: 6 MB
  • Akceptowane typy MIME multimediów: image/jpeg, image/png, application/octet-stream

Wpływ na limit: wywołanie tej metody ma koszt limitu wynoszący 50 jednostek.

Prośba

Żądanie HTTP

POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert

Upoważnienie

To żądanie wymaga autoryzacji z użyciem co najmniej jednego z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

Zakres
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametry

W tabeli poniżej znajdziesz parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry opcjonalne
onBehalfOfContentOwner string
Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla dostawców treści w YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądanie identyfikują użytkownika YouTube CMS działającego w imieniu właściciela treści określonego w wartości parametru. Jest on przeznaczony dla dostawców treści w YouTube, którzy mają wiele różnych kanałów w YouTube i nimi zarządzają. Dzięki niej właściciele treści mogą jednorazowo uwierzytelnić się i uzyskiwać dostęp do wszystkich swoich filmów oraz danych dotyczących kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik uwierzytelnia się, musi być powiązane z określonym właścicielem treści YouTube.

Treść żądania

Nie podawaj treści żądania podczas wywoływania tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci w treści odpowiedzi zasób channelBanner.

Błędy

W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
badRequest (400) bannerAlbumFull Twój album z grafiką kanału w YouTube zawiera zbyt wiele obrazów. Otwórz http://photos.google.com, otwórz stronę albumów i usuń niektóre zdjęcia z tego albumu.
badRequest (400) mediaBodyRequired Żądanie nie zawiera obrazów.

Wypróbuj

Użyj interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.