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