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-канала, на который ведет ссылка в изображении водяного знака.