Method: advertisers.campaigns.delete

  • Display & Video 360 API v2 is sunset and this documentation details permanently deleting a campaign using the API.

  • Before deletion, campaigns should be archived by setting their entityStatus to ENTITY_STATUS_ARCHIVED.

  • The DELETE request requires specifying the advertiser ID and campaign ID in the URL path.

  • The method may experience high latency, so increasing the default timeout is recommended.

  • Authorization requires specific OAuth scopes like https://www.googleapis.com/auth/display-video or https://www.googleapis.com/auth/display-video-mediaplanning.

Permanently deletes a campaign. A deleted campaign cannot be recovered. The campaign should be archived first, i.e. set entityStatus to ENTITY_STATUS_ARCHIVED, to be able to delete it.

This method regularly experiences high latency. We recommend increasing your default timeout to avoid errors.

HTTP request

DELETE https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/campaigns/{campaignId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

The ID of the advertiser this campaign belongs to.
campaignId

string (int64 format)

The ID of the campaign we need to delete.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the OAuth 2.0 Overview.