Sklik API

Keywords

keywords.check

Check keywords attributes before updating a keyword or creating a new one. You can not change name or matchType of an existing keyword (you can remove this keyword and create a new one). Therefore if keyword definition in keywords array contains id - it cannot contain name or matchType.

Parameters

struct user {
string session Session (as retrieved from client.login())
int userId (optional) Managed user ID
}
array keywords (
struct {
int id (optional) Keyword ID, that will be updated (excludes: name, matchType)
int groupId (optional) Group ID, where the keyword will be created (have to be set name and matchType fields)
string name (optional) Keyword
string matchType (optional) Keyword match type:
  • broad: Broad match; query must contain all words from keyword, in any order
  • phrase: Phrase match ("keyword"); keyword must match query with words in correct order
  • exact: Exact match ([keyword]); keyword must match exactly entire query
  • negativeBroad: Negative broad match (-keyword); query must not contain words from this keyword
  • negativePhrase: Negative phrase match (-"keyword"); query must not contain keyword words in correct order
  • negativeExact: Negative exact match (-[keyword]); query must not exactly match this keyword
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: [default: active]
  • active: Active (default for check create)
  • suspend: Suspended
}
)

Response

struct {
int status Status code
string statusMessage Status code description
string session Refreshed session
array diagnostics ( (optional) Various diagnostics(warnings, errors, other information)
struct {
...
}
)
}

Response status codes:

List of all possible response status codes:

Diagnostics:

List of all possible diagnostics:

            
        

Copyright © 1996-2018

www.seznam.cz   Help   Contact