メディア アップロード機能を使用すると、ディスプレイ＆ビデオ 360 で使用できるデータを保存できます。写真、動画、zip ファイルなど、さまざまな形式のデータをアップロードできます。
アップロード オプション
ディスプレイ＆ビデオ 360 API を使用して、特定の種類のバイナリデータまたはメディアをアップロードできます。アップロードできるデータの特性については、メディア アップロードが必要なタスクのデベロッパー ガイドをご覧ください。
- アップロード ファイルの最大サイズ: この方法で保存できるデータ量の上限。
- 使用可能なメディア MIME タイプ: この方法で保存できるバイナリデータのタイプ。
アップロード リクエストは次のいずれかの方法で行えます。使用するメソッドは、uploadType パラメータで指定します。
- シンプル アップロード（
uploadType=media）。約 5 MB 以下のファイルを高速で転送します。 - マルチパート アップロード（
uploadType=multipart）。ファイルと関連するメタデータを高速で転送します。ファイルとメタデータを 1 つのリクエストですべて転送します。
メディアをアップロードするときは、/upload URI を使用します。この URI は、メディアデータそのものを転送する場合に使用します。
例:
POST /upload/media/resource-name
シンプル アップロード
シンプル アップロード リクエストは、ファイルをアップロードする最も簡単な方法です。この方法は、次のような場合に適しています。
- ファイルが小さく、必要に応じて再度アップロードできる場合。
- 送信するメタデータがない場合。メタデータが不要な場合や、リクエストの別の場所にメタデータが含まれている場合などです。
シンプル アップロードを使用するには、メソッドの /upload URI への POST リクエストまたは PUT リクエストを作成し、クエリ パラメータ uploadType=media を追加します。次に例を示します。
POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media
シンプル アップロードの実行時に使用する HTTP ヘッダーの内容は次のとおりです。
Content-Type: メソッドで使用できるメディア データタイプのいずれかに設定します。Content-Length: アップロードするバイト数に設定します。チャンク形式の転送エンコードを使用する場合は不要です。
マルチパート アップロード
アップロードするデータとともに送信するメタデータがある場合は、multipart/related リクエストを作成できます。この方法は、送信するデータが小さく、必要に応じて再アップロードできる場合に適しています。
マルチパート アップロードを使用するには、メソッドの /upload URI への POST リクエストまたは PUT リクエストを作成し、クエリ パラメータ uploadType=multipart を追加します。次に例を示します。
POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart
マルチパート アップロード リクエストの作成時に使用する最上位の HTTP ヘッダーの内容は次のとおりです。
Content-Type。これをmultipart/relatedに設定し、リクエストの各部分の識別に使用する境界文字列を含めます。Content-Length。リクエスト本文の合計バイト数を設定します。リクエストのメディア部分は、このアップロード方法で指定したファイルサイズの上限より小さくする必要があります。
リクエスト本文の形式は multipart/related コンテンツ タイプ（RFC2387）として設定され、厳密に 2 つのパートで構成されます。パートはバウンダリ文字列で識別され、最後のバウンダリ文字列の後に 2 つのハイフンが続きます。
マルチパート リクエストの各部分には、次の Content-Type ヘッダーを追加する必要があります。
- メタデータ部分: 最初に配置する必要があります。
Content-Typeは、受け入れ可能なメタデータ形式のいずれかと一致する必要があります。 - メディアパート: 2 番目に配置する必要があります。
Content-Typeは、アップロード方法で使用可能なメディア MIME タイプのいずれかと一致しなければなりません。
例
ディスプレイ＆ビデオ 360 API を使用してメディアをアップロードし、さまざまなタスクを実行します。このセクションでは、curl リクエストの例を示します。
クリエイティブ アセットをアップロードする
クリエイティブ アセットをアップロードする手順は次のとおりです。
curl --request POST \
'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
--header 'Authorization: Bearer access-token' \
-F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
-F "file=@asset-path;type=asset-mime-type"詳細とコード例については、クリエイティブ アセットをアップロードするガイドをご覧ください。
カスタム入札スクリプト ファイルをアップロードする
スクリプト ファイルをアップロードする方法は次のとおりです。
curl --request POST \
'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
-H 'authorization: Bearer access-token' \
-H 'Content-Type: text/plain' \
--data-binary @script-path詳細とコード例については、アップロード スクリプト ガイドをご覧ください。