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