Resume

Resumes impressions for keywords. The keywords may be for different campaigns or ad groups.

Alert

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.

Restrictions

Alert

This method only supports campaigns with the “Text & Image Ads” type. To manage keywords in all types of campaigns, use the Keywords service in version 5 of the API.

Input data

The input data structure in JSON is shown below.

{
   "method": "Keyword",
   "param": {
      /* KeywordRequest */
      "Action": (string),
      "Login": (string),
      "KeywordIDS": [
         (long)
         ...
      ]
   }
}

Parameters are described below.

Parameter

Description

Required

KeywordRequest object

Action

Action: Resume.

Yes

Login

The username of the client to perform the operation for.

A direct advertiser can optionally specify the username of a chief representativechief representative.

For agencies

KeywordIDS

Array of keywords IDs (maximum 10,000).

Yes

Output data

Note

Errors that occur when starting individual keywords (54 if the user doesn't have editing permissions for the keyword, 194, and 195) do not cause the entire operation to be canceled and do not affect the success of starting other keywords.

The output data structure in JSON is shown below.

{
   "data": {
      /* KeywordResponse */
      "ActionsResult": [
         {  /* KeywordActionResult */
            "Warnings": [
               {  /* Warning */
                  "WarningCode": (int),
                  "WarningString": (string),
                  "Description": (string)
               }
               ...
            ],
            "Errors": [
               {  /* Error */
                  "FaultCode": (int),
                  "FaultString": (string),
                  "FaultDetail": (string)
               }
               ...
            ],
            "KeywordID": (long)
         }
         ...
      ]
   }
}

Parameters are described below.

Parameter

Description

KeywordResponse object

ActionsResult

Array of KeywordActionResult objects. Each object corresponds to an item in the KeywordIDS input array and contains:

  • Keyword ID.
  • Array of Errors or array of Warnings if they occurred when executing the operation on this keyword.

KeywordActionResult object

Warnings

Array of Warning objects describing issues that occurred while performing the operation.

Errors

Array of Error objects with errors that occurred while performing the operation.

KeywordID

Keyword ID.

Warning object

WarningCode

Warning code: 212 or 213.

WarningString

Warning text.

Description

Contains an empty structure.

Error object

FaultCode

Error code.

FaultString

Textual message about the error.

FaultDetail

Detailed description of the reason for the error.

Examples of input data

Python

{
   'Action': 'Resume',
   'Login': 'agrom',
   'KeywordIDS': [199381759,199482870,200725193]
}

PHP

array(
   'Action' ='Resume',
   'Login' ='agrom',
   'KeywordIDS' =array(199381759,199482870,200725193)
)

Perl

{
   'Action' ='Resume',
   'Login' ='agrom',
   'KeywordIDS' =[199381759,199482870,200725193]
}
Previous
Next