批量添加推广组
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/group/batchAdd
字段 |
类型 |
必须 |
描述 |
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"]} |
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。 |