Method: advertisers.insertionOrders.delete

  • Deletes an existing insertion order that has been archived (ENTITY_STATUS_ARCHIVED).

  • Requires providing the advertiser ID and the insertion order ID in the request path.

  • Uses an HTTP DELETE request with an empty request body to perform the deletion.

  • Returns an empty response body upon successful deletion and a NOT_FOUND error if the insertion order doesn't exist.

  • Needs authorization with the https://www.googleapis.com/auth/display-video 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/v3/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 an empty JSON object.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.