批量更新推广计划
根据计划id批量更新相应的推广计划
HTTP请求方式
POST
请求地址
https://ms-api.e.360.cn/v1/plan/batch_update
字段 |
类型 |
必须 |
描述 |
Content-Type |
string |
yes |
application/x-www-form-urlencoded |
apiKey |
string |
yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken |
string |
yes |
访问token |
Body 请求参数
字段 |
类型 |
必须 |
描述 |
campaigns |
string |
yes |
json格式的推广计划数组,单次请求提交数量最多 100 个 |
campaigns示例
[
{
"id": 607120225,
"budget": 90,
"disabled": 3,
"equalbudgetflag": 1
},
{
"id": 607120566,
"budget": 9,
"disabled": 1,
"equalbudgetflag": 1,
"schedule": "[{\"week\":1,\"hour\":[1,1,1,1,0,0,1,1,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]},{\"week\":2,\"hour\":[0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]},{\"week\":5,\"hour\":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}]"
}
]
campaigns字段说明
字段 |
类型 |
必须 |
描述 |
id |
int |
yes |
推广计划id |
budget |
int |
no |
推广计划每日预算具体金额(单位:元,大于等于30小于等于移动推广预算且为10的倍数),0表示不限 |
schedule |
string |
no |
json格式,Week字段1-7 表示周一至周日,若其中一星期某天不投放,可跳过,hour 总数为24(有且只能有24),其中0为此时段不投放,1为投放。传空不修改。例:[{“week”:1,”hour”:[1,1,1,1,1,1,1,1,1,1……]},{“week”:3,”hour”: [1,0,1,1,1,0,1,1,1,1……]}…… |
equalbudgetflag |
int |
no |
预算消耗方式:1快速,0匀速 |
disabled |
int |
no |
推广计划状态:0启用, 1暂停,2删除 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'campaigns=[{"id": 607120225,"budget": 90,"disabled": 3, "equalbudgetflag": 1},{"id": 607120566,"budget": 9,"disabled": 1, "equalbudgetflag": 1,"schedule": "[{\"week\":1,\"hour\":[1,1,1,1,0,0,1,1,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]},{\"week\":2,\"hour\":[0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]},{\"week\":5,\"hour\":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}]"}]
' \
'https://ms-api.e.360.cn/v1/plan/batch_update'
返回结果
{
"err_no": 10000,
"err_msg": "",
"data": {
"affectedRecords": 0,
"failIds": [
607120225,
607120566
],
"failures": [
{
"code": 1001001,
"description": "",
"message": "计划ID:607120225,状态值无效"
},
{
"code": 1001001,
"description": "",
"message": "计划ID:607120566,预算不能小于30元"
}
]
}
}
返回结果说明
字段 |
类型 |
描述 |
affectedRecords |
int |
更新成功的个数 |
failIds |
array |
更新失败的ID |
failures |
array |
更新失败的错误信息,与failIds中的id顺序一一对应 |