添加关键词
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/keyword/add
字段 |
类型 |
必须 |
描述 |
apiKey |
String |
Yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken |
String |
Yes |
身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin |
Body 请求参数
字段 |
类型 |
必须 |
描述 |
keywords |
String |
Yes |
JSON 格式的关键词对象数组,单次请求提交数量最多 500 个 |
keywords示例
[{
"groupId": 123456,
"word": "关键词1",
"price": 0.3,
"url": "http://www.360.cn",
"mobileUrl": "http://www.360.cn/top.html",
"matchType": "exact",
"status": "pause"
},
{
"groupId": 1234567,
"word": "关键词2",
"price": 0.6,
"url": "http://www.360.cn",
"mobileUrl": "http://www.360.cn/top.html",
"matchType": "phrase",
"status": "pause"
}
]
keywords参数说明
字段 |
类型 |
必须 |
描述 |
groupId |
int |
Yes |
推广组id |
word |
String |
Yes |
关键词 |
price |
double |
Yes |
关键词出价,price 可以为 0,表示默认为推广组出价 |
url |
String |
Yes |
pc端url,可以为空"",表示使用创意的链接网址 |
mobileUrl |
String |
Yes |
移动端url,可以为空"",表示使用创意的链接网址 |
matchType |
String |
Yes |
关键词匹配方式:exact表示精确,phrase 表示短语,broad 表示广泛匹配,phrase_intelligence表示智能短语,商品组只能填写exact和phrase_accurate |
deeplinkUrl |
string |
No |
应用调起网址 (账户需要开通对应权限) |
status |
String |
No |
启用/暂停状态,enable-启用,pause-暂停,默认启用 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'keywords=[{"groupId":1709638749,"word":"关键词auto-exec","price":0.3,"url":"http://dartsearch.net","mobileUrl":"http://dartsearch.net/top.html","matchType":"exact","status":"pause"}]' \
'https://api.e.360.cn/dianjing/keyword/add'
返回结果
{
"errno": 10000,
"keywordIdList": [5145334164],
"failures": []
}
返回结果说明
字段 |
类型 |
描述 |
keywordIdList |
string |
新增的关键词id数组,每个id和keywords参数中的顺序一致,如果某个关键词插入失败,对应的id为0 |