Watermarks

watermark Zasób identyfikuje obraz wyświetlany podczas odtwarzania filmów z określonego kanału. Możesz też określić kanał docelowy, do którego będzie prowadzić link z obrazu, oraz szczegóły dotyczące czasu, które określają, kiedy znak wodny ma się pojawiać podczas odtwarzania filmów i jak długo ma być widoczny.

Metody

Interfejs API obsługuje te metody dla zasobów watermarks:

set

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

unset

Usuwa obraz znaku wodnego kanału. Wypróbuj teraz

Prezentacja zasobów

Struktura JSON poniżej przedstawia format zasobu watermarks:

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": string
}

Właściwości

W tej tabeli znajdziesz definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
timing	object Obiekt timing zawiera informacje o czasie odtwarzania filmu, w którym będzie wyświetlany obraz znaku wodnego kanału. Ten obiekt jest wymagany podczas wywoływania funkcji watermarks.set.
timing.type	string Metoda określania czasu, która decyduje o tym, kiedy obraz znaku wodnego jest wyświetlany podczas odtwarzania filmu. Ta właściwość jest wymagana podczas wywoływania funkcji watermarks.set. Prawidłowe wartości: offsetFromStart: Pole offsetMs reprezentuje przesunięcie od początku filmu. offsetFromEnd: pole offsetMs reprezentuje przesunięcie od końca filmu.
timing.offsetMs	unsigned long Przesunięcie czasowe w milisekundach, które określa, kiedy promowany produkt pojawia się podczas odtwarzania filmu. Ta właściwość jest wymagana podczas wywoływania funkcji watermarks.set. Gdy type ma wartość offsetFromEnd, wartość offsetMs musi wynosić co najmniej 1000 milisekund.
timing.durationMs	unsigned long Czas wyświetlania obrazu znaku wodnego w milisekundach. Ta właściwość jest opcjonalna. Jeśli jest określony, minimalny czas trwania wynosi 1000 milisekund. Gdy type ma wartość offsetFromEnd, parametr durationMs nie może przekraczać wartości offsetMs.
position	object Wycofany: obiekt position jest wycofany i ignorowany przez YouTube. Znaki wodne zawsze wyświetlają się w prawym górnym rogu odtwarzacza.
imageUrl	string Adres URL obrazu znaku wodnego kanału. YouTube wygeneruje ten adres URL i zwróci go w odpowiedzi interfejsu API na żądanie watermark.set.
imageBytes	bytes Rozmiar obrazu znaku wodnego w bajtach.
targetChannelId	string Identyfikator kanału w YouTube, z którym jest połączony obraz znaku wodnego.