Watermarks

watermark 資源可識別特定頻道影片播放期間顯示的圖片。您也可以指定圖片連結的目標頻道，以及有關浮水印在影片播放期間出現的時間及顯示時間長度。

方法

這個 API 支援下列 watermarks 資源方法：

設定

將浮水印圖片上傳至 YouTube 並設定頻道。

未設定

刪除頻道的浮水印圖片。 立即試用。

資源表示法

下列 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。