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