Watermarks: set

Przesyła obraz znaku wodnego do YouTube i ustawia go dla kanału.

Ta metoda obsługuje przesyłanie multimediów. Przesłane pliki muszą spełniać te ograniczenia:

  • 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 wiąże się z kosztem limitu w wysokości 50 jednostek.

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/upload/youtube/v3/watermarks/set

Autoryzacja

To żądanie wymaga autoryzacji z użyciem co najmniej jednego z tych zakresów. Więcej informacji o uwierzytelnianiu i autoryzacji 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 parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry to parametry zapytania.

Parametry
Parametry wymagane
channelId string
Parametr channelId określa identyfikator kanału w YouTube, dla którego podawany jest znak wodny.
Parametry opcjonalne
onBehalfOfContentOwner string
Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube zajmujących się treściami.

Parametr onBehalfOfContentOwner wskazuje, że dane logowania 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 YouTube, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Umożliwia właścicielom treści jednorazowe uwierzytelnianie i uzyskiwanie dostępu do wszystkich danych dotyczących filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w YouTube.

Treść żądania

W treści żądania podaj zasób watermark. Zasób zawiera te właściwości:

  • timing (object, wymagane): określa czas wyświetlania znaku wodnego.
    • timing.type (string, wymagany): ustaw wartość offsetFromStart lub offsetFromEnd.
    • timing.offsetMs (unsigned long, wymagany): przesunięcie początku w milisekundach. Jeśli type ma wartość offsetFromEnd, musi wynosić co najmniej 1000 ms.
    • timing.durationMs (unsigned long, opcjonalny): czas widoczności w milisekundach (minimum 1000 ms). Jeśli type ma wartość offsetFromEnd, nie może przekraczać offsetMs.
  • targetChannelId (string, opcjonalnie): identyfikator kanału w YouTube, do którego prowadzi znak wodny. Jeśli ten argument nie zostanie podany, link prowadzi do kanału wskazanego przez element channelId.
  • position (object, wycofany): ignorowany przez YouTube. Znaki wodne są zawsze umieszczane w prawym górnym rogu.

Odpowiedź

Jeśli operacja się uda, ta metoda 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 YouTube Data API – błędy.

Typ błędu Szczegóły błędu Opis
badRequest (400) imageFormatUnsupported Przesłany obraz jest w nieobsługiwanym formacie.
badRequest (400) imageTooTall Podany obraz jest za wysoki.
badRequest (400) imageTooWide Przesłany obraz jest za szeroki.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści obrazu.
forbidden (403) forbidden Nie można ustawić znaku wodnego dla wybranego kanału. Żądanie może nie być prawidłowo autoryzowane lub parametr channelId ma nieprawidłową wartość.

Wypróbuj

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