2025 年 9 月 8 日以降、すべての新しい広告申込情報で、欧州連合(EU)の政治広告を配信するかどうかを宣言する必要があります。宣言が提供されていないディスプレイ&ビデオ 360 API と SDF のアップロードは失敗します。統合を更新してこの宣言を行う方法について詳しくは、
非推奨のページをご覧ください。
Method: advertisers.assets.upload
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
アセットをアップロードします。成功した場合は、新しくアップロードされたアセットの ID を返します。アセット ファイルのサイズは、画像の場合は 10 MB、ZIP ファイルの場合は 200 MB、動画の場合は 1 GB 以下にしてください。
マルチパート メディア アップロード プロセス内で使用する必要があります。提供されているクライアント ライブラリを使用した例については、クリエイティブの作成ガイドをご覧ください。
HTTP リクエスト
- アップロード URI(メディアのアップロード リクエストの場合):
POST https://displayvideo.googleapis.com/upload/v4/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 Overview をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],null,["# Method: advertisers.assets.upload\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.CreateAssetResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUploads an asset. Returns the ID of the newly uploaded asset if successful. The asset file size should be no more than 10 MB for images, 200 MB for ZIP files, and 1 GB for videos.\n\nMust be used within the [multipart media upload process](/display-video/api/guides/how-tos/upload#multipart). Examples using provided client libraries can be found in our [Creating Creatives guide](/display-video/api/guides/creating-creatives/overview#upload_an_asset).\n\n### HTTP request\n\n- Upload URI, for media upload requests: \n `POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/assets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the advertiser this asset belongs to. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------|\n| ``` { \"filename\": string } ``` |\n\n| Fields ||\n|------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `filename` | `string` Required. The filename of the asset, including the file extension. The filename must be UTF-8 encoded with a maximum size of 240 bytes. |\n\n### Response body\n\nA response message for [assets.upload](/display-video/api/reference/rest/v4/advertisers.assets/upload#google.ads.displayvideo.v4.AssetService.CreateAsset).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------|\n| ``` { \"asset\": { object (/display-video/api/reference/rest/v4/advertisers.creatives#Asset) } } ``` |\n\n| Fields ||\n|---------|---------------------------------------------------------------------------------------------------------------------------|\n| `asset` | `object (`[Asset](/display-video/api/reference/rest/v4/advertisers.creatives#Asset)`)` The uploaded asset, if successful. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]