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