watermark
資源會識別特定頻道影片播放時要顯示的圖片。您也可以指定要連結圖片的目標頻道,以及決定影片播放期間浮水印顯示時間和顯示時間的時間詳細資訊。
方法
這個 API 支援下列 watermarks
資源的方法:
資源表示法
以下 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 用來顯示促銷商品的播放器角落。項目一律會顯示在播放器的右上角。 這個屬性的有效值如下:
|
imageUrl |
string 頻道浮水印圖片的網址。YouTube 會產生這個網址,並會在 API 回應中傳回 watermark.set 要求。 |
imageBytes |
bytes 浮水印圖片的大小 (以位元組為單位)。 |
targetChannelId |
string 浮水印圖片連結的頻道的 YouTube 頻道 ID。 |