Watermarks

watermark リソースは、指定したチャンネルの動画の再生中に表示される画像を識別します。画像のリンク先ターゲット チャンネルや、動画の再生中に透かしを表示するタイミングとその長さを指定することもできます。

Methods

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 動画プレーヤー内でのプロモーション アイテムの配置方法。 このプロパティの有効な値は次のとおりです。 corner
position.cornerPosition	string プロモート アイテムが表示されるプレーヤーの隅。アイテムは常にプレーヤーの右上に表示されます。 このプロパティの有効な値は次のとおりです。 topRight
imageUrl	string チャンネルの透かし画像の URL。YouTube はこの URL を生成し、watermark.set リクエストに対する API レスポンスで返します。
imageBytes	bytes 透かし画像のサイズ（バイト単位）。
targetChannelId	string 透かし画像がリンクしているチャンネルの YouTube チャンネル ID。