计划列表
HTTP请求方式
GET
请求地址
https://ms-api.e.360.cn/v1/plan/list
字段 |
类型 |
必须 |
描述 |
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点可投放; |