Watermarks

Zasób watermark określa obraz, który wyświetla się podczas odtwarzania filmów na danym kanale. Możesz też podać kanał docelowy, do którego będzie prowadził obraz, a także szczegóły czasowe, które określają, kiedy znak wodny będzie się wyświetlać podczas odtwarzania filmu i jak długo będzie on widoczny.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów watermarks:

Ustaw

Przesyła obraz ze znakiem wodnym do YouTube i ustawia go dla kanału.

nieskonfigurowana

Usuwa obraz wodny kanału. Wypróbuj teraz

Reprezentowanie 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
}

Usługi

Poniższa tabela określa właściwości, które pojawiają się w tym zasobie:

Usługi
timing	object Obiekt timing zawiera informacje o czasie odtwarzania filmu, kiedy wyświetlany jest znak wodny kanału.
timing.type	string Metoda synchronizacji czasowej, która określa, kiedy obraz powinien być wyświetlany podczas odtwarzania filmu. Jeśli wartość to offsetFromStart, pole offsetMs wskazuje przesunięcie od początku filmu. Jeśli wartość wynosi offsetFromEnd, pole offsetMs wskazuje przesunięcie względem końca filmu.
timing.offsetMs	unsigned long Opóźnienie w milisekundach, które określa, kiedy promowany produkt pojawi się podczas odtwarzania filmu. Wartość właściwości type określa, czy przesunięcie jest mierzone od początku czy 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 filmu, w którym wyświetla się znak wodny.
position.type	string Pozycja promowanego elementu w odtwarzaczu. Prawidłowe wartości tej właściwości: narożnik
position.cornerPosition	string Narożnik odtwarzacza, w którym pojawi się promowany produkt. Element zawsze jest widoczny w prawym górnym rogu odtwarzacza. Prawidłowe wartości to: topRight
imageUrl	string Adres URL obrazu znaku wodnego kanału. YouTube wygeneruje ten adres URL i zwróci go w odpowiedzi 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 ze znakiem wodnym.