update

Changes sets of negative keywords.

  1. Restrictions
  2. Request
  3. Response

Restrictions

Maximum 30 sets of negative keywords per method call.

Request

Request structure in JSON format:

{
  "method": "update",
  "params": { /* params */
    "NegativeKeywordSharedSets": [{  /* NegativeKeywordSharedSetUpdateItem */
      "Id": (long), /* required */
      "Name": (string),
      "NegativeKeywords": [(string), ... ] 
    }, ... ] /* required */
  }
} 
Parameter Type Description Required
Params structure (for JSON) / UpdateRequest structure (for SOAP)
NegativeKeywordSharedSets array of NegativeKeywordSharedSetUpdateItem Sets of negative keywords to change. Maximum of 30 items in the array. Yes
NegativeKeywordSharedSetUpdateItem structure
Id long ID of the retargeting list. Yes
Name string Name of a set of negative keywords (maximum 255 characters). No
NegativeKeywords array of string

Array of negative keywords.

A keyword should be specified without the minus sign before the first word.

Maximum of 7 words per keyword. The maximum length of each word is 35 characters. The maximum combined length of negative keywords in the array is 4096 characters. Spaces, dashes, and operators are not counted as part of the total length.

No
Parameter Type Description Required
Params structure (for JSON) / UpdateRequest structure (for SOAP)
NegativeKeywordSharedSets array of NegativeKeywordSharedSetUpdateItem Sets of negative keywords to change. Maximum of 30 items in the array. Yes
NegativeKeywordSharedSetUpdateItem structure
Id long ID of the retargeting list. Yes
Name string Name of a set of negative keywords (maximum 255 characters). No
NegativeKeywords array of string

Array of negative keywords.

A keyword should be specified without the minus sign before the first word.

Maximum of 7 words per keyword. The maximum length of each word is 35 characters. The maximum combined length of negative keywords in the array is 4096 characters. Spaces, dashes, and operators are not counted as part of the total length.

No

Response

Response structure in JSON format:

{
  "result": {  /* result */
    "UpdateResults": [{  /* 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) / UpdateResponse structure (for SOAP)
UpdateResults array of ActionResult The results of changing the sets of negative keywords.
ActionResult structure
Id long ID of the set of negative keywords. 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) / UpdateResponse structure (for SOAP)
UpdateResults array of ActionResult The results of changing the sets of negative keywords.
ActionResult structure
Id long ID of the set of negative keywords. 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.