Watermarks

watermark 资源用于标识在指定频道的视频播放期间显示的图片。您还可以指定图片要关联的目标频道以及时间详情，以确定水印何时在视频播放期间出现以及显示的时间长度。

方法

对于 watermarks 资源，该 API 支持以下方法：

设置
将水印图片上传到 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
频道水印图片的网址。YouTube 将生成此网址，并在对 watermark.set 请求的 API 响应中返回此网址。
imageBytes bytes
水印图片的大小（以字节为单位）。
targetChannelId string
水印图片关联的频道的 YouTube 频道 ID。