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 會產生這個網址,並會在 API 回應中傳回 watermark.set 要求。
imageBytes bytes
浮水印圖片的大小 (以位元組為單位)。
targetChannelId string
浮水印圖片連結的頻道的 YouTube 頻道 ID。