Method: advertisers.insertionOrders.delete

  • Display & Video 360 API v2 has been sunset and this documentation details how to delete an insertion order using the API.

  • To delete an insertion order, it must first be archived by setting its entityStatus to ENTITY_STATUS_ARCHIVED.

  • The API request requires the advertiser ID and insertion order ID as path parameters and an empty request body.

  • A successful deletion will result in an empty response body, while an attempt to delete a non-existent insertion order returns a NOT_FOUND error.

  • Authorization for this API request requires the https://www.googleapis.com/auth/display-video OAuth scope.

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.

HTTP request

DELETE https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

The ID of the advertiser this insertion order belongs to.
insertionOrderId

string (int64 format)

The ID of the insertion order to delete.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.