Method: advertisers.campaigns.delete

AI-generated Key Takeaways

• Campaigns can be permanently deleted, but cannot be recovered.

• A campaign must be archived (entityStatus set to ENTITY_STATUS_ARCHIVED) before it can be deleted.

• Deleting a campaign is done using a DELETE HTTP request to a specific URL with advertiserId and campaignId in the path parameters.

• The request body for deleting a campaign must be empty, and a successful response body is also empty.

• Authorization to delete campaigns requires specific OAuth scopes like https://www.googleapis.com/auth/display-video.

Display & Video 360 API v1 has been sunset.

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

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.