Watermarks: set

YouTube に透かし画像をアップロードし、チャンネルに設定します。

このメソッドはメディア アップロードをサポートしています。アップロードするファイルには、以下の制約が適用されます。

  • 最大ファイルサイズ: 10MB
  • 使用可能なメディア MIME タイプ: image/jpegimage/pngapplication/octet-stream

割り当ての影響:このメソッドを呼び出すと、割り当てコストは 50 単位になります。

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/upload/youtube/v3/watermarks/set

承認

このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です(認証と承認の詳細をご確認ください)。

範囲
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

パラメータ

次の表に、このクエリがサポートするパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。

パラメータ
必須パラメータ
channelId string
channelId パラメータには、ウォーターマークを指定する YouTube チャンネル ID を指定します。
オプション パラメータ
onBehalfOfContentOwner string
注: このパラメータは、YouTube コンテンツ パートナー専用です。

onBehalfOfContentOwner パラメータは、パラメータ値で指定されたコンテンツ所有者に代わって行動する YouTube CMS ユーザーを識別するリクエストの認証情報です。このパラメータは、複数の YouTube チャンネルを所有、管理している YouTube コンテンツ パートナーを対象にしています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、すべての動画やチャンネル データにアクセスできるようになります。チャンネルごとに認証情報を指定する必要はありません。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。

リクエスト本文

リクエストの本文にウォーターマーク リソースを指定します。

レスポンス

成功すると、このメソッドは HTTP 204 レスポンス コード(No Content)を返します。

エラー

次の表に、このメソッドの呼び出しに応じて API から返される可能性のあるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。

エラーのタイプ エラーの詳細 説明
badRequest (400) imageFormatUnsupported 指定した画像の形式はサポートされていません。
badRequest (400) imageTooTall 指定した画像の高さが高すぎます。
badRequest (400) imageTooWide 指定された画像の幅が広すぎます。
badRequest (400) mediaBodyRequired リクエストに画像コンテンツが含まれていません。
forbidden (403) forbidden 指定したチャネルには、透かしを設定できません。リクエストが正しく承認されていないか、channelId パラメータが無効な値に設定されています。

実習

APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。