add
Creates sets of negative keywords.
Restrictions
Maximum 30 sets of negative keywords per advertiser.
Maximum 30 sets of negative keywords per method call.
Request
Request structure in JSON format:
{
"method": "add",
"params": { /* params */
"NegativeKeywordSharedSets": [{ /* NegativeKeywordSharedSetAddItem */
"Name": (string), /* required */
"NegativeKeywords": [(string), ... ] /* required */
}, ... ] /* required */
}
}
Parameter | Type | Description | Required |
Params structure (for JSON) / AddRequest structure (for SOAP) | |||
---|---|---|---|
NegativeKeywordSharedSets | array of NegativeKeywordSharedSetAddItem | Sets of negative keywords to add. Maximum of 30 items in the array. | Yes |
NegativeKeywordSharedSetAddItem structure | |||
Name | string | Name of a set of negative keywords (maximum 255 characters). | Yes |
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. | Yes |
Parameter | Type | Description | Required |
Params structure (for JSON) / AddRequest structure (for SOAP) | |||
---|---|---|---|
NegativeKeywordSharedSets | array of NegativeKeywordSharedSetAddItem | Sets of negative keywords to add. Maximum of 30 items in the array. | Yes |
NegativeKeywordSharedSetAddItem structure | |||
Name | string | Name of a set of negative keywords (maximum 255 characters). | Yes |
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. | Yes |
Response
Response structure in JSON format:
{
"result": { /* result */
"AddResults": [{ /* ActionResult */
"Id": (long),
"Warnings": [{ /* ExceptionNotification */
"Code": (int), /* required */
"Message": (string), /* required */
"Details": (string)
}, ... ],
"Errors": [{ /* ExceptionNotification */
"Code": (int), /* required */
"Message": (string), /* required */
"Details": (string)
}, ... ]
}, ... ]
}
}
Parameter | Type | Description |
Result structure (for JSON) / AddResponse structure (for SOAP) | ||
---|---|---|
AddResults | array of ActionResult | Results of adding sets of negative keywords. |
ActionResult structure | ||
Id | long | ID of the created 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) / AddResponse structure (for SOAP) | ||
---|---|---|
AddResults | array of ActionResult | Results of adding sets of negative keywords. |
ActionResult structure | ||
Id | long | ID of the created 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. |