Watermarks

Zasób watermark określa obraz, który wyświetla się podczas odtwarzania filmów z konkretnego kanału. Możesz też określić kanał docelowy, do którego będzie prowadzić obraz. Możesz też określić czas, który określa, kiedy znak wodny pojawi się podczas odtwarzania filmu i jak długo jest widoczny.

Metody

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

ustaw
Przesyła obraz znaku wodnego do YouTube i ustawia go dla kanału.
Cofnij ustawienie
Usuwa znak wodny kanału. Wypróbuj teraz

Reprezentacja zasobu

Poniższa struktura JSON 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 przedstawia 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 wyświetlany jest znak wodny kanału.
timing.type string
Metoda synchronizacji określająca, kiedy obraz znaku wodnego wyświetla się podczas odtwarzania filmu. Jeśli wartość wynosi offsetFromStart, pole offsetMs przedstawia przesunięcie od początku filmu. Jeśli wartość to offsetFromEnd, pole offsetMs przedstawia przesunięcie względem końca filmu.
timing.offsetMs unsigned long
Opóźnienie w milisekundach, które określa, kiedy promowany element pojawia się podczas odtwarzania filmu. Wartość właściwości type określa, czy przesunięcie ma być mierzone od początku czy od końca filmu.
timing.durationMs unsigned long
Czas wyświetlania znaku wodnego (w milisekundach).
position object
Obiekt position zawiera informacje o położeniu przestrzennym w filmie, w którym będzie wyświetlany obraz znaku wodnego.
position.type string
Sposób pozycji promowanego produktu w odtwarzaczu.

Prawidłowe wartości tej właściwości to:
  • narożnik
position.cornerPosition string
W rogu odtwarzacza, w którym pojawi się promowany produkt. Element zawsze wyświetla 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 obraz znaku wodnego.