keywords.update
Update keywords attributes.
Keyword name or matchType cannot be changed; if you need so, remove it
and create a new one.
Parameters
struct |
user { |
|
string |
session |
Session (as retrieved from client.loginByToken() )
|
int |
userId |
(optional) Managed user ID
|
|
} |
|
|
array |
keywords ( |
|
struct |
{ |
|
int |
cpc |
(optional) (can be null) Change keyword maximal CPC (in halers) or nil to use group default
|
string |
url |
(optional) (can be null) Change (or unset if nil) keyword target URL
|
string |
status |
(optional) Change keyword status:
-
active :
Active
-
suspend :
Suspended
|
|
} |
|
|
|
) |
|
|
Response
struct |
{ |
|
string |
statusMessage |
Status code description
|
string |
session |
Refreshed session
|
array |
diagnostics ( |
(optional) Various diagnostics(warnings, errors, other information)
|
|
) |
|
|
|
} |
|
|
Response status codes:
List of all possible response status codes:
200: OK
206: Partially OK
301: User is serviced
400: Bad arguments
401: Invalid session
403: Access Denied
404: Not found
406: Bad values of attributes
413: Too many items requested.
429: Too many requests. Has to wait.
500: Server Error.
409: Conflict
Diagnostics:
List of all possible diagnostics:
ambiguous_check: Some items contain keyword `id` and some `groupId` or for check `create` attributes `name` or `matchType` are missing! Can not recognize check category (create or update?)
keyword_access_denied
keyword_cpc_is_too_low
keyword_cpc_out_of_range
keyword_duplicate
keyword_name_forbidden_chars
keyword_name_missing
keyword_name_too_long
keyword_name_with_too_many_words
keyword_url_is_not_url
not_allowed_for_campaign_type
user_access_denied