Method: advertisers.campaigns.delete

  • Permanently deletes a specified campaign, which cannot be undone and requires the campaign to be archived beforehand.

  • The API endpoint uses a DELETE request with the advertiser and campaign IDs as path parameters.

  • An empty request body is required, and a successful deletion results in an empty response body.

  • Proper authorization is necessary, requiring specific OAuth scopes for access.

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.

HTTP request

DELETE https://displayvideo.googleapis.com/v1/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.