Ab dem
8. September 2025 muss für jede neue Werbebuchung angegeben werden, ob Werbung mit politischen Inhalten in der Europäischen Union (EU) ausgeliefert wird. Display & Video 360 API- und SDF-Uploads ohne entsprechende Erklärungen schlagen fehl. Weitere Informationen dazu, wie Sie Ihre Integration aktualisieren, um diese Erklärung abzugeben,
finden Sie auf unserer Seite zur Einstellung.
Method: advertisers.assets.upload
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Lädt ein Asset hoch. Gibt bei Erfolg die ID des neu hochgeladenen Assets zurück. Die Asset-Datei darf maximal 10 MB für Bilder, 200 MB für ZIP-Dateien und 1 GB für Videos groß sein.
Muss im Rahmen des mehrteiligen Medienuploads verwendet werden. Beispiele für die Verwendung der bereitgestellten Clientbibliotheken finden Sie in unserem Leitfaden zum Erstellen von Creatives.
HTTP-Anfrage
- Upload-URI für Anfragen zum Hochladen von Medien:
POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/assets
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
advertiserId |
string (int64 format)
Erforderlich. Die ID des Werbetreibenden, dem dieses Asset gehört.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
{
"filename": string
} |
| Felder |
filename |
string
Erforderlich. Der Dateiname des Assets, einschließlich der Dateiendung. Der Dateiname muss UTF-8-codiert sein und darf maximal 240 Byte lang sein.
|
Antworttext
Eine Antwortnachricht für assets.upload.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"asset": {
object (Asset)
}
} |
| Felder |
asset |
object (Asset)
Das hochgeladene Asset, falls der Upload erfolgreich war.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/display-video
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
