Method: advertisers.insertionOrders.delete

AI-generated Key Takeaways

• Deletes an insertion order, requiring the insertion order to be archived first by setting its entityStatus to ENTITY_STATUS_ARCHIVED.

• Returns an error code NOT_FOUND if the specified insertion order does not exist.

• The HTTP request uses the DELETE method with the specific URL including advertiserId and insertionOrderId as path parameters.

• The request body must be empty, and a successful response body is an empty JSON object.

• Deleting an insertion order requires the https://www.googleapis.com/auth/display-video OAuth scope.

Display & Video 360 API v3 has sunset. Use v4 instead.

• HTTP request
• Path parameters
• Request body
• Response body
• Authorization scopes
• Try it!

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.