批量添加推广组
HTTP请求方式
POST
请求地址
Headers 请求参数
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
apiKey | String | Yes | 注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken | String | Yes | 身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin |
Body 请求参数
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
groups | String | Yes | JSON 格式的推广组对象数组,单次请求提交数量最多100个。 |
groups 请求示例
[
{
"campaignId": "1306991174",
"name": "测试组1",
"price": "2",
"status": "pause",
"negativeWords": {
"phrase": ["up短语匹配1"],
"exact": ["up精确1","精确2"]
}
}
]
groups 字段说明
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
campaignId | int | Yes | 推广计划id |
name | String | Yes | 推广组名称 |
price | double | Yes | 推广组出价 |
negativeWords | Json | No | 匹配方式为短语匹配或者精确匹配的否定关键词(短语不得超过200个,精确不得超过400个),使用JSON格式:其中phrase 代表短语 exact 代表精确 {"phrase":["短语匹配1"],"exact":["精确1","精确2"]} |
industryTags | Json | No | 推广组投放业务(目前仅支持IT产品、机械设备、电子电工、教育培训行业填写投放业务,其他行业敬请期待),用户投放业务列表不为空时必传。使用 JSON 格式,包含以下字段: • path: 数组类型,表示投放业务路径编码,从一级到四级业务编码依次排列 • literal: 字符串类型,当叶子节点为自定义行业时必传。必须以"其他-"为前缀 示例1 - 标准业务路径: { "path": [11,21,31,41] } 示例2 - 自定义行业: { "path": [14,24,34], "literal": "其他-模拟游戏行业" } |
status | String | No | 启用/暂停状态,enable-启用,pause-暂停,默认启用 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'groups=[{"campaignId":"1306991174","name":"测试组1","price":"2","status":"pause","negativeWords":{"phrase":["up短语匹配1"],"exact":["up精确1","精确2"]}},{"campaignId":"1306991174","name":"测试组2","price":"2","status":"pause","negativeWords":{"phrase":["up短语匹配1"],"exact":["up精确1","精确2"]}}]' \
'https://api.e.360.cn/dianjing/group/batchAdd
返回结果
{
"groupIdList":[1810333277],
"failures":[]
}
返回结果说明
字段 | 类型 | 描述 |
---|---|---|
groupIdList | Int | 新增的推广组id数组,每个id和groups参数中的顺序一致,如果某个推广组新建失败,对应的id为0。 |