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 w przypadku 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

Poniższa tabela zawiera 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.
timing.type string
Metoda określania czasu, która decyduje o tym, kiedy obraz znaku wodnego jest wyświetlany podczas odtwarzania filmu. Jeśli wartość to offsetFromStart, pole offsetMs reprezentuje przesunięcie od początku filmu. Jeśli wartość to 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. Wartość właściwości type określa, czy przesunięcie jest mierzone od początku czy od końca filmu.
timing.durationMs unsigned long
Czas wyświetlania obrazu znaku wodnego (w milisekundach).
position object
Obiekt position zawiera informacje o położeniu w filmie, w którym będzie wyświetlany obraz znaku wodnego.
position.type string
Sposób pozycjonowania promowanego produktu w odtwarzaczu wideo.

Prawidłowe wartości tej właściwości to:
  • róg,
position.cornerPosition string
Róg odtwarzacza, w którym będzie się wyświetlać promowany element. Element zawsze pojawia się w prawym górnym rogu odtwarzacza.

Prawidłowe wartości tej właściwości to:
  • topRight
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, do którego prowadzi link z obrazu znaku wodnego.