Starting September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details on how to update your integration to make this declaration.
Deletes 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 to ENTITY_STATUS_ARCHIVED, to be able to delete it.
[null,null,["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eDisplay & Video 360 API v2 has been sunset and this documentation details how to delete an insertion order using the API.\u003c/p\u003e\n"],["\u003cp\u003eTo delete an insertion order, it must first be archived by setting its entityStatus to \u003ccode\u003eENTITY_STATUS_ARCHIVED\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe API request requires the advertiser ID and insertion order ID as path parameters and an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eA successful deletion will result in an empty response body, while an attempt to delete a non-existent insertion order returns a \u003ccode\u003eNOT_FOUND\u003c/code\u003e error.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this API request requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["The Display & Video 360 API v2 is no longer available. To delete an insertion order, first archive it by setting its `entityStatus` to `ENTITY_STATUS_ARCHIVED`. Then, use a DELETE request to `https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}`, providing the advertiser and insertion order IDs. The request body must be empty, and a successful deletion returns an empty response body. The OAuth scope `https://www.googleapis.com/auth/display-video` is required for authorization.\n"],null,["# Method: advertisers.insertionOrders.delete\n\n| Display \\& Video 360 API v2 has sunset.\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/v2/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/v2/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 empty.\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](https://developers.google.com/identity/protocols/OAuth2)."]]
