Starting September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details on how to update your integration to make this declaration.
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.
[null,null,["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eDisplay & Video 360 API v2 is sunset and this documentation details permanently deleting a campaign using the API.\u003c/p\u003e\n"],["\u003cp\u003eBefore deletion, campaigns should be archived by setting their entityStatus to \u003ccode\u003eENTITY_STATUS_ARCHIVED\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe DELETE request requires specifying the advertiser ID and campaign ID in the URL path.\u003c/p\u003e\n"],["\u003cp\u003eThe method may experience high latency, so increasing the default timeout is recommended.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires specific OAuth scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/display-video-mediaplanning\u003c/code\u003e.\u003c/p\u003e\n"]]],["The Display & Video 360 API v2 is no longer available. To permanently delete a campaign, a DELETE request is sent to a specified URL, including `advertiserId` and `campaignId` as path parameters. Before deletion, the campaign's `entityStatus` should be set to `ENTITY_STATUS_ARCHIVED`. The request body must be empty, and a successful response is also empty. The process often has high latency, with timeouts advised. OAuth scopes are required for authorization.\n"],null,["# Method: advertisers.campaigns.delete\n\n| Display \\& Video 360 API v2 has sunset.\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nPermanently deletes a campaign. A deleted campaign cannot be recovered. The campaign should be archived first, i.e. set [entityStatus](/display-video/api/reference/rest/v2/advertisers.campaigns#Campaign.FIELDS.entity_status) to `ENTITY_STATUS_ARCHIVED`, to be able to delete it.\n\n**This method regularly experiences high latency.** We recommend [increasing your default timeout](/display-video/api/guides/best-practices/timeouts#client_library_timeout) to avoid errors.\n\n### HTTP request\n\n`DELETE https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/campaigns/{campaignId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser this campaign belongs to. |\n| `campaignId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the campaign we need to delete. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/display-video`\n- `https://www.googleapis.com/auth/display-video-mediaplanning`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
