批量更新推广计划


根据计划id批量更新相应的推广计划

HTTP请求方式

POST

请求地址

https://ms-api.e.360.cn/v1/plan/batch_update

Headers 请求参数
字段 类型 必须 描述
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顺序一一对应

results matching ""

    No results matching ""