ChannelBanners: insert

Przesyła do YouTube obraz banera kanału. Ta metoda obejmuje 2 pierwsze kroki 3-etapowego procesu aktualizacji obrazu banera kanału:

  1. 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.
  2. Wyodrębnij wartość właściwości url z odpowiedzi zwróconej przez interfejs API w kroku 1.
  3. Aby zaktualizować ustawienia marki kanału, wywołaj metodę channels.update. Ustaw wartość właściwości brandingSettings.image.bannerExternalUrl na 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.

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów. Więcej informacji o uwierzytelnianiu i autoryzowaniu znajdziesz w artykule Wdrażanie autoryzacji OAuth 2.0.

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 listę parametrów obsługiwanych 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 partnerów treści YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające autoryzacji żądania identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów treści YouTube, którzy są właścicielami wielu kanałów YouTube i nimi zarządzają. Umożliwia ona właścicielom treści jednorazową weryfikację i uzyskanie dostępu do wszystkich danych o filmach i kanałach bez konieczności podawania danych uwierzytelniających dla każdego kanału. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści w YouTube.

Treść żądania

Podczas wywoływania tej metody nie podawaj treści żądania.

Odpowiedź

Jeśli operacja się powiedzie, zwróci ona 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 informacji znajdziesz w artykule Błędy w interfejsie YouTube Data API.

Typ błędu Szczegóły błędu Opis
badRequest (400) bannerAlbumFull Twój album z grafiką kanału w YouTube zawiera za dużo obrazów. Aby to naprawić, otwórz Zdjęcia Google, przejdź na stronę albumów i usuń z albumu niektóre obrazy.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści obrazu.

Wypróbuj

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