Method: advertisers.creatives.delete
Deletes a creative. Returns error code NOT_FOUND
if the creative does not exist. The creative should be archived first, i.e. set entityStatus
to ENTITY_STATUS_ARCHIVED
, before it can be deleted.
A "Standard" user role or greater for the parent advertiser or partner is required to make this request.
HTTP request
DELETE https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/creatives/{creativeId}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
advertiserId |
string (int64 format)
The ID of the advertiser this creative belongs to.
|
creativeId |
string (int64 format)
The ID of the creative to be deleted.
|
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["Deletes a specified creative belonging to an advertiser, requiring prior archival of the creative."],["Only users with \"Standard\" role or higher for the parent advertiser or partner can perform this deletion."],["The request utilizes a `DELETE` method with advertiser and creative IDs as path parameters, and an empty request body."],["A successful deletion results in an empty response body, while a non-existent creative triggers a `NOT_FOUND` error."],["Authorization necessitates the `https://www.googleapis.com/auth/display-video` OAuth scope."]]],["This document details the process of deleting a creative within an advertiser's account. Deletion requires a \"Standard\" or greater user role. The creative must first be archived by setting its `entityStatus` to `ENTITY_STATUS_ARCHIVED`. A `DELETE` HTTP request is sent to the specified URL, including `advertiserId` and `creativeId` as path parameters. The request body should be empty. A successful deletion returns an empty JSON object; if the creative doesn't exist, `NOT_FOUND` is returned. The operation requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"]]