Method: advertisers.lineItems.delete

AI-generated Key Takeaways

• Display & Video 360 API v2 has been sunset and YouTube & Partners line items cannot be created or updated using the API.

• This documentation details the process for deleting a line item using the API, requiring it to be archived beforehand.

• The API request utilizes an HTTP DELETE method with specific path parameters for advertiser and line item identification.

• Successful deletion results in an empty response body, while errors like a non-existent line item return a NOT_FOUND code.

• Authorization for this operation necessitates the https://www.googleapis.com/auth/display-video OAuth scope.

Display & Video 360 API v2 has sunset.

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

Deletes a line item.

Returns error code NOT_FOUND if the line item does not exist.

The line item should be archived first, i.e. set entityStatus to ENTITY_STATUS_ARCHIVED, to be able to delete it.

YouTube & Partners line items cannot be created or updated using the API.

HTTP request

DELETE https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems/{lineItemId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId	string (int64 format) The ID of the advertiser this line item belongs to.
lineItemId	string (int64 format) The ID of the line item 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.