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