suspend

Stops impressions at the campaign level.

Restrictions

Maximum of 1000 campaigns per method call.

Request

Request structure in JSON format:

{
  "method": "suspend",
  "params": { /* params */
    "SelectionCriteria": {  /* IdsCriteria */
      "Ids": [(long), ... ] /* required */
    } /* required */
  }
}

Parameter

Type

Description

Required

params structure (for JSON) / SuspendRequest structure (for SOAP)

SelectionCriteria

IdsCriteria

Criteria for selecting campaigns to suspend.

Yes

IdsCriteria structure

Ids

array of long

IDs of campaigns to suspend (maximum of 1000).

Yes

Response

Response structure in JSON format:

{
  "result": { /* result */
    "SuspendResults": [{  /* 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) / SuspendResponse structure (for SOAP)

SuspendResults

array of ActionResult

Results of suspending campaigns.

ActionResult structure

Id

long

The campaign 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.

Previous