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.