计划列表


HTTP请求方式

GET

请求地址

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

Headers 请求参数
字段 类型 必须 描述
Content-Type string yes application/x-www-form-urlencoded
apiKey string yes 注册时分配到的api key,该参数作为HTTP HEAD字段传递。
accessToken string yes 访问token
Get 请求参数
字段 类型 必须 描述
modify_time_begin string yes 最后修改时间起始,精确到秒,例子:2020-01-01 01:00:23
modify_time_end string yes 最后修改时间结束,精确到秒,例子:2020-01-02 01:00:50
page int no 请求的页码,默认为第1页
per_page_count int no 每页返回记录数,默认100,最大1000
请求示例
curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'adverts=[{"modify_time_begin":"2020-01-01 01:00:33","modify_time_end":"2020-01-02 01:00:50","page":1' \ 
'https://ms-api.e.360.cn/v1/plan/list'
返回结果
{
    "err_no": 10000,
    "err_msg": "",
    "data": {
        "count": 58,
        "list": [
          {
            "id": 36931654,
            "name": "下载-安卓-动态创意",
            "disabled": 0,
            "start_date": "2019-03-16T00:00:00+08:00",
            "end_date": "2038-01-18T00:00:00+08:00",
            "ad_style": 1,
            "app_id": 1954941,
            "apk_id": 0,
            "ad_type": 1,
            "status": 1,
            "budget": 0,
            "last_modified": "2020-08-24T19:20:13+08:00",
            "equal_budget_flag": 1,
            "status_consume": 1,
            "os": 1,
            "status_app": 1,
            "run_time": [
              {
                "week_day_bit": "0000001",
                "hour_bit": "111111111111111111111011"
              },
              {
                "week_day_bit": "0000010",
                "hour_bit": "111111111111111111110111"
              },
              {
                "week_day_bit": "0000100",
                "hour_bit": "111111111111111111101111"
              },
              {
                "week_day_bit": "0001000",
                "hour_bit": "111111111111111111011111"
              },
              {
                "week_day_bit": "0010000",
                "hour_bit": "111111111111111110111111"
              }
            ]
          },
          {
            "id": 607007977,
            "name": "fds32333",
            "disabled": 0,
            "start_date": "2019-01-22T00:00:00+08:00",
            "end_date": "2038-01-18T00:00:00+08:00",
            "ad_style": 1,
            "app_id": 1954941,
            "apk_id": 0,
            "ad_type": 1,
            "status": 1,
            "budget": 0,
            "last_modified": "2020-08-24T19:20:13+08:00",
            "equal_budget_flag": 1,
            "status_consume": 1,
            "os": 1,
            "status_app": 1,
            "run_time": [
              {
                "week_day_bit": "1111111",
                "hour_bit": "111111111111111111111111"
              }
            ]
          }
        ]
    }
}
返回结果说明
字段 类型 描述
count Number 总条数
list Json 组列表,详见下方《list字段说明》
list字段说明
字段 类型 描述
id Number 计划ID
name String 计划名称
ad_model String 广告模式
disabled Number 计划状态:0已启用、1暂停
start_date String 计划投放开始时间
end_date String 计划投放结束时间
app_id Number 被投放app的ID
apk_id Number 被投放渠道包的ID
ad_type Number 推广目的:0应用激活、1应用下载、2移动网站推广
budget Number 每日预算(单位为分),0为无限制
last_modified String 最后修改时间
equal_budget_flag Number 预算消耗方式:0匀速、1快速
status_consume Number 预算状态:0不足、1正常
os Number 操作系统:1安卓、2IOS
status_app Number 被投放安卓app的状态:0无效、1有效
run_time Json 投放时段,详见下方《投放时段说明》
投放时段说明
字段 类型 描述
week_day_bit String 每星期可投放天设置,由0、1组成的7位长度的二进制串(0代表不投放、1代表投放),从后往前依次为星期一到星期日。例1:0000101代表星期一、星期三可投放;例2:0101000代表星期四、星期六可投放;
hour_bit String 可投放时段,和week_day_bit是与的关系,由0、1组成的24位长度的二进制串(0代表不投放、1代表投放),从后往前依次为0点到23点。例1:111111111111111111111011代表除2点外都可投放;例2:000001000000000000000000代表仅18点可投放;

results matching ""

    No results matching ""