keywords.create
Create new groups keywords.
Parameters
| struct |
user { |
|
| string |
session |
Session (as retrieved from client.loginByToken())
|
| int |
userId |
(optional) Managed user ID
|
|
} |
|
|
| array |
keywords ( |
|
| struct |
{ |
|
| int |
groupId |
Id of the group in which will be the keyword created
|
| string |
matchType |
(optional) Keyword match type: [default: broad]
-
broad:
Broad match; query must contain all words from keyword, in any order (default)
-
phrase:
Phrase match (`"keyword"`); keyword must match query with words in correct order
-
exact:
Exact match (`[keyword]`); keyword must match exactly entire query
|
| int |
cpc |
(optional) (can be null) Keyword max cost per click (in halers) or nil for using the group default
|
| string |
url |
(optional) (can be null) Target URL (or nil for no target URL, which is default)
|
| string |
status |
(optional) Keyword status: [default: active]
-
active:
Active (default)
-
suspend:
Suspended
|
|
} |
|
|
|
) |
|
|
Response
| struct |
{ |
|
| string |
statusMessage |
Status code description
|
| string |
session |
Refreshed session
|
| array |
positiveKeywordIds ( |
New positive keyword ids
|
) |
|
|
| array |
diagnostics ( |
(optional) Various diagnostics(warnings, errors, other information)
|
|
|
) |
|
|
|
} |
|
|
Response status codes:
List of all possible response status codes:
200: OK206: Partially OK301: User is serviced400: Bad arguments401: Invalid session403: Access Denied404: Not found406: Bad values of attributes413: Too many items requested.429: Too many requests. Has to wait.500: Server Error.409: Conflict
Diagnostics:
List of all possible diagnostics:
floating_invalid_targetinggroup_access_deniedkeyword_cpc_is_too_lowkeyword_cpc_out_of_rangekeyword_duplicatekeyword_name_forbidden_charskeyword_name_missingkeyword_name_too_longkeyword_name_with_too_many_wordskeyword_url_is_not_urlnot_allowed_for_campaign_typesimple_ads_invalid_targetinguser_access_denied
