Watermarks: set

Przesyła obraz znaku wodnego do YouTube i ustawia go na kanale.

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

  • Maksymalny rozmiar pliku: 10 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/watermarks/set

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/youtubepartner
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 wymagane
channelId string
Parametr channelId określa identyfikator kanału w YouTube, dla którego ma być wyświetlany znak wodny.
Parametry opcjonalne
onBehalfOfContentOwner string
Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów treści w YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające autoryzacji żądania identyfikują użytkownika YouTube CMS, 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 w 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 logowania do 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

W treści żądania podaj zasób watermark.

Odpowiedź

Jeśli operacja się powiedzie, zwróci kod stanu HTTP 204 No Content.

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) imageFormatUnsupported Podany obraz ma nieobsługiwany format.
badRequest (400) imageTooTall Podany obraz jest za wysoki.
badRequest (400) imageTooWide Podany obraz jest za szeroki.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści obrazu.
forbidden (403) forbidden Nie można ustawić znaku wodnego na określonym kanale. Żądanie może nie być prawidłowo autoryzowane lub parametr channelId może mieć nieprawidłową wartość.

Wypróbuj

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