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。