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 инкапсулирует информацию о времени воспроизведения видео, когда будет отображаться изображение водяного знака канала.
timing. type string
Метод синхронизации, определяющий момент отображения водяного знака во время воспроизведения видео. Если значение равно offsetFromStart , то поле offsetMs представляет смещение от начала видео. Если значение равно offsetFromEnd , то поле offsetMs представляет смещение от конца видео.
timing. offsetMs unsigned long
Смещение по времени, указанное в миллисекундах, которое определяет момент появления рекламируемого элемента при воспроизведении видео. Значение свойства type определяет, отсчитывается ли смещение от начала или от конца видео.
timing. durationMs unsigned long
Продолжительность времени (в миллисекундах), в течение которого должно отображаться изображение водяного знака.
position object
Объект position инкапсулирует информацию о пространственном положении внутри видео, где будет отображаться изображение водяного знака.
position. type string
Способ позиционирования рекламируемого элемента в видеоплеере.

Допустимые значения для этого свойства:
  • угол
position. cornerPosition string
Угол плеера, где будет отображаться продвигаемый предмет. Предмет всегда отображается в правом верхнем углу плеера.

Допустимые значения для этого свойства:
  • topRight
imageUrl string
URL-адрес водяного знака канала. YouTube сгенерирует этот URL-адрес и вернет его в ответе API на запрос watermark.set .
imageBytes bytes
Размер изображения водяного знака в байтах.
targetChannelId string
Идентификатор канала YouTube, на который ссылается изображение водяного знака.