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": { /* params */
"SelectionCriteria": { /* IdsCriteria */
"Ids": [(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 long | IDs of ads to submit for review (maximum of 10,000). | Yes |
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 long | IDs of ads to submit for review (maximum of 10,000). | Yes |
Response
Response structure in JSON format:
{
"result": { /* result */
"ModerateResults": [{ /* 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) / ModerateResponse structure (for SOAP) | ||
---|---|---|
ModerateResults | array of ActionResult | Results of submitting for review. |
ActionResult structure | ||
Id | long | The ad ID. Returned if there aren't any 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. |
Parameter | Type | Description |
Result structure (for JSON) / ModerateResponse structure (for SOAP) | ||
---|---|---|
ModerateResults | array of ActionResult | Results of submitting for review. |
ActionResult structure | ||
Id | long | The ad ID. Returned if there aren't any 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. |