Documentation

moderate

Submits ads for review.

Restrictions

A maximum of 10,000 ads per method call.

Only ads with the DRAFT status can be submitted for review.

Ads can't be submitted for review if the ad group doesn't have any targeting criteria (keywords, audience targets, or dynamic text ad targets). Ads can't be submitted for review if they belong to an archived campaign.

Request

Request structure in JSON format:

{
  "method": "moderate",
  "params": {  
    "SelectionCriteria
[no-highlight[

Criteria for selecting ads to submit for review.

Required

Yes

]no-highlight]
": { /* IdsCriteria */ "Ids
[no-highlight[

IDs of ads to submit for review (no more than 10,000).

Required

Yes

]no-highlight]
": [(long), ... ] /* required */ } /* required */ } }
Parameter Type Description Required
params structure (for JSON) / ModerateRequest structure (for SOAP)
SelectionCriteria IdsCriteria Criteria for selecting ads to submit for review.Yes
IdsCriteria structure
Ids array of longIDs of ads to submit for review (no more than 10,000).Yes

Response

Response structure in JSON format:

{
  "result": { 
    "ModerateResults
[no-highlight[

Results of submitting for review.

]no-highlight]
": [{ /* ActionResult */ "Id
[no-highlight[

The ad ID. Returned if there are no errors; see the section Operations on object arrays.

]no-highlight]
": (long), "Warnings
[no-highlight[

Warnings that occurred during the operation.

]no-highlight]
": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ], "Errors
[no-highlight[

Errors that occurred during the operation.

]no-highlight]
": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ] }, ... ] /* required */ } }
Parameter Type Description
result structure (for JSON) / ModerateResponse structure (for SOAP)
ModerateResults array of ActionResultResults of submitting for review.
ActionResult structure
Id longThe ad ID. Returned if there are no errors; see the section Operations on object arrays.
Warnings array of ExceptionNotification

Warnings that occurred during the operation.

Errors array of ExceptionNotification

Errors that occurred during the operation.