Watermarks

Ресурс watermark представляет собой изображение, которое показывается во время воспроизведения видео на определенном канале. Вы также можете указать целевой канал, на который будет вести водяной знак, а также время его появления и продолжительность показа.

Методы

API поддерживает следующие методы для ресурсов watermarks:

set

Загружает изображение водяного знака на YouTube и устанавливает его для канала.

unset

Удаляет изображение водяного знака канала. Перейти

Представление ресурса

Ниже показана структура JSON для ресурса watermarks.

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": string
}

Свойства

В таблице ниже приведены свойства, которые используются в этом ресурсе.

Свойства
timing	object Объект timing содержит информацию о времени показа логотипа канала во время воспроизведения видео. Этот объект необходим при вызове watermarks.set.
timing.type	string Метод, определяющий, когда во время воспроизведения видео показывается водяной знак. Это свойство обязательно при вызове watermarks.set. Допустимые значения: offsetFromStart: поле offsetMs представляет собой смещение от начала видео. offsetFromEnd: поле offsetMs представляет собой смещение от конца видео.
timing.offsetMs	unsigned long Смещение по времени в миллисекундах, определяющее, когда продвигаемый объект появляется во время воспроизведения видео. Это свойство обязательно при вызове watermarks.set. Если для параметра type задано значение offsetFromEnd, то значение параметра offsetMs должно быть не менее 1000 миллисекунд.
timing.durationMs	unsigned long Продолжительность показа водяного знака в миллисекундах. Это необязательное свойство. Если указано, минимальная продолжительность составляет 1000 миллисекунд. Если в поле type указано значение offsetFromEnd, то значение в поле durationMs не должно превышать offsetMs.
position	object Поддержка прекращена. Объект position больше не поддерживается и игнорируется YouTube. Водяной знак всегда показывается в правом верхнем углу видеопроигрывателя.
imageUrl	string URL изображения водяного знака канала. YouTube сгенерирует этот URL и вернет его в ответе API на запрос watermark.set.
imageBytes	bytes Размер изображения водяного знака в байтах.
targetChannelId	string Идентификатор канала YouTube, на который ссылается логотип.