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.insertionOrders.delete
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Löscht einen Anzeigenauftrag. Gibt den Fehlercode NOT_FOUND zurück, wenn der Anzeigenauftrag nicht vorhanden ist. Der Anzeigenauftrag muss zuerst archiviert werden, d.h. entityStatus auf ENTITY_STATUS_ARCHIVED gesetzt werden, damit er gelöscht werden kann.
HTTP-Anfrage
DELETE https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
advertiserId |
string (int64 format)
Die ID des Werbetreibenden, zu dem dieser Anzeigenauftrag gehört.
|
insertionOrderId |
string (int64 format)
Die ID des zu löschenden Anzeigenauftrags.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.
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)."],[],["The Display & Video 360 API v4 allows the deletion of insertion orders via a `DELETE` HTTP request. The request URL requires `advertiserId` and `insertionOrderId` path parameters. Before deletion, the insertion order's `entityStatus` must be set to `ENTITY_STATUS_ARCHIVED`. The request body should be empty. A successful deletion returns an empty JSON object. If the insertion order is not found, a `NOT_FOUND` error code is returned. This operation requires the `https://www.googleapis.com/auth/display-video` authorization scope.\n"],null,["# Method: advertisers.insertionOrders.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes an insertion order. Returns error code `NOT_FOUND` if the insertion order does not exist. The insertion order should be archived first, i.e. set [entityStatus](/display-video/api/reference/rest/v4/advertisers.insertionOrders#InsertionOrder.FIELDS.entity_status) to `ENTITY_STATUS_ARCHIVED`, to be able to delete it.\n\n### HTTP request\n\n`DELETE https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}`\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)` The ID of the advertiser this insertion order belongs to. |\n| `insertionOrderId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the insertion order to delete. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\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)."]]
