delete
Deletes ads.
Learn more
Restrictions
A maximum of 10,000 ads per method call.
Ads can't be deleted in the following cases:
- The ad was displayed and it has accumulated statistics.
- The ad has a status other than DRAFT, and the campaign has at least one ad that is currently being activated or suspended.
- The ad was accepted after review or rejected after being pre-accepted, although there were funds in the campaign or shared account.
You can use the archive method to archive these types of ads.
Request
Request structure in JSON format:
{
"method": "delete",
"params": { /* params */
"SelectionCriteria": { /* IdsCriteria */
"Ids": [(long), ... ] /* required */
} /* required */
}
}
|
Parameter |
Type |
Description |
Required |
|
params structure (for JSON) / DeleteRequest structure (for SOAP) |
|||
|
|
IdsCriteria |
Criteria for selecting ads to delete. |
Yes |
|
IdsCriteria structure |
|||
|
|
array of long |
IDs of the ads that you want to delete (no more than |
Yes |
Response
Response structure in JSON format:
{
"result": { /* result */
"DeleteResults": [{ /* ActionResult */
"Id": (long),
"Warnings": [{ /* ExceptionNotification */
"Code": (int), /* required */
"Message": (string), /* required */
"Details": (string)
}, ...
],
"Errors": [{ /* ExceptionNotification */
"Code": (int), /* required */
"Message": (string), /* required */
"Details": (string)
}, ...
]
}, ... ] /* required */
}
}
|
Parameter |
Type |
Description |
|
result structure (for JSON) / DeleteResponse structure (for SOAP) |
||
|
|
array of ActionResult |
Results of deleting ads. |
|
ActionResult structure |
||
|
|
long |
ID of the ad that was deleted. Returned if there aren't any errors. See the section Operations on object arrays. |
|
|
array of ExceptionNotification |
Warnings that occurred during the operation. |
|
|
array of ExceptionNotification |
Errors that occurred during the operation. |