Method: advertisers.sdfuploadtasks.upload

SDF アップロード タスクを作成します。Operation を返します。

SDF アップロード タスクは、長時間実行される非同期オペレーションです。このオペレーションの metadata タイプは SdfUploadTaskMetadata です。リクエストが成功すると、オペレーションの response タイプは SdfUploadTask になります。レスポンスには結果のファイルは含まれません。このファイルは media.download を使用して取得できます。

オペレーションの状態は sdfuploadtask.operations.get で取得できます。

エラーは error.message で確認できます。error.details は空であることが想定されます。

HTTP リクエスト

  • アップロード URI（メディアのアップロード リクエストの場合）:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • メタデータ URI（メタデータのみの追加リクエストの場合）:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
advertiserId

string (int64 format)

必須。SDF をアップロードする広告主の ID。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
フィールド
filename

string

必須。ファイル拡張子を含むアセットのファイル名。ファイル名は UTF-8 でエンコードし、最大サイズは 240 バイトにする必要があります。
sdfVersion

enum (SdfVersion)

必須。アップロードされたファイルの SDF バージョン。SDF_VERSION_UNSPECIFIED に設定すると、デフォルトは、識別された広告主によって指定されたバージョンになります。広告主は、特に設定しない限り、SDF バージョンをパートナーから継承します。

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/display-video

詳細については、OAuth 2.0 Overview をご覧ください。