ModerateBanners (Live)

Submits an ad with “Draft” status for moderation.

Attention.

Disabled method. Use version 5 of the API.

For information about the compatibility of methods between versions Live 4 and 5, see the Migration guide.

This method is used for moderating ads for campaigns that have just been created. Such campaigns and their ads have the “Draft” status.

If a campaign has at least one ad that is active or submitted for moderation, other ads are automatically submitted for moderation when they are created or edited. In this case, invoking the ModerateBanners method returns an error message with the error code 155.

New in the Live 4 version

It is sufficient to set either one of the parameters CampaignID or BannerIDS. If both are set, BannerIDS has priority.

Input data

The input data structure in JSON is shown below.

{
   "method": "ModerateBanners",
   "param": {
      /* CampaignBidsInfo */
      "CampaignID": (int),
      "BannerIDS": [
         (long)
         ...
      ]
   }
}

Parameters are described below.

Parameter Description Required
CampaignBidsInfo object
CampaignID

The campaign ID. Ads with the “Draft” status are submitted for moderation. If the campaign does not have any such ads, the method returns the value 0.

CampaignID or BannerIDS
BannerIDS

IDs of ads for moderation with the “Draft” status (no more than 2000 IDs).

When the BannerIDS parameter is set, the CampaignID parameter is ignored.

Parameter Description Required
CampaignBidsInfo object
CampaignID

The campaign ID. Ads with the “Draft” status are submitted for moderation. If the campaign does not have any such ads, the method returns the value 0.

CampaignID or BannerIDS
BannerIDS

IDs of ads for moderation with the “Draft” status (no more than 2000 IDs).

When the BannerIDS parameter is set, the CampaignID parameter is ignored.

Output data

Returns 1 when executed successfully, as shown in the following example.

{
   "data": 1
}

Examples of input data

Python

{
   'CampaignID': 3665578
}

PHP

array(
   'CampaignID' => 3665578
)

Perl

{
   'CampaignID' => 3665578
}