Method: advertisers.lineItems.delete

  • Deletes a specific line item within a given advertiser, requiring the line item to be archived beforehand.

  • Identifies the target line item and advertiser using their respective IDs in the request URL.

  • Returns an error if the line item is not found or is a YouTube & Partners line item, as those cannot be managed via the API.

  • Requires authorization with the https://www.googleapis.com/auth/display-video scope.

  • Utilizes a DELETE request with an empty body and returns an empty body upon successful deletion.

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/v3/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 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.