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:
|
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:
|
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. |