更新关键词

HTTP请求方式

POST

请求地址

https://api.e.360.cn/dianjing/keyword/update

Headers 请求参数

字段	类型	必须	描述
apiKey	String	Yes	注册时分配到的api key，该参数作为HTTP HEAD字段传递。
accessToken	String	Yes	身份认证通过后平台分配的临时token，作为操作对应广告账户的凭证，10小时有效。参数获取方式见接口clientLogin

Body 请求参数

字段	类型	必须	描述
keywords	String	Yes	JSON 格式的关键词对象数组，单次请求提交数量最多 500 个。关键词匹配方式：exact 表示精确，phrase 表示短语，broad 表示广泛匹配，phrase_intelligence表示智能短语。每个关键词对象可包含属性（id 必须，status、price、url、mobileUrl、 matchType 至少有一项）；其中 price 可以为 0，表示默认为推广组出价；url 和 mobileUrl 可以为空""，表示使用创意的链接网址。不做修改的字段不上传

keywords示例

[{
        "id": 123456,
        "status": "enable",
        "price": 0.3
    },
    {
        "id": 987654,
        "price": 1.2,
        "url": "http://www.360.cn",
        "mobileUrl": "http://m.360.cn/top.html",
        "matchType": "broad"
    }
]

keywords参数说明

字段	类型	必须	描述
id	int	Yes	关键词id
price	double	No	关键词出价，price 可以为 0，表示默认为推广组出价
url	String	No	pc端url，可以为空""，表示使用创意的链接网址
mobileUrl	String	No	移动端url，可以为空""，表示使用创意的链接网址
matchType	String	No	关键词匹配方式：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=[{"id":5145334164,"status":"enable","price":1.3}]' \ 
'https://api.e.360.cn/dianjing/keyword/update'

返回结果

{
    "errno": 10000,
    "affectedRecords": 1,
    "failKeywordIds": "[]",
    "failures": []
}

返回结果说明

affectedRecords	类型	描述
affectedRecords	int	更新成功的关键词个数
failKeywordIds	string	如果部分关键词提交的数据不合法（如price太低），相应的id会在返回结果中列出，不影响其他关键词的更新

results matching ""

No results matching ""