Method: advertisers.assets.upload

アセットをアップロードします。成功した場合は、新しくアップロードされたアセットの ID を返します。アセット ファイルのサイズは、画像の場合は 10 MB、ZIP ファイルの場合は 200 MB、動画の場合は 1 GB 以下にする必要があります。

マルチパート メディア アップロード プロセス内で使用する必要があります。提供されているクライアント ライブラリを使用した例については、クリエイティブの作成ガイドをご覧ください。

HTTP リクエスト

  • アップロード URI(メディアのアップロード リクエストの場合):
    POST https://displayvideo.googleapis.com/upload/v3/advertisers/{advertiserId}/assets

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

パスパラメータ

パラメータ
advertiserId

string (int64 format)

必須。このアセットが属する広告主の ID。

リクエスト本文

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

JSON 表現
{
  "filename": string
}
フィールド
filename

string

必須。ファイル拡張子を含むアセットのファイル名。

ファイル名は UTF-8 でエンコードし、最大サイズは 240 バイトにする必要があります。

レスポンスの本文

assets.upload に対するレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "asset": {
    object (Asset)
  }
}
フィールド
asset

object (Asset)

アップロードされたアセット(成功した場合)。

認可スコープ

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

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

詳しくは、OAuth 2.0 の概要をご覧ください。