批量获取推广计划信息
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/campaign/getInfoByIdList
字段 |
类型 |
必须 |
描述 |
apiKey |
String |
Yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken |
String |
Yes |
身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin。 |
Body请求参数
字段 |
类型 |
必须 |
描述 |
idList |
string |
Yes |
json格式的id数组,如[1000001,20000001,3000001],去重后数量限制100 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'idList=[3907501127,3924245063,3924246343]' \
'https://api.e.360.cn/dianjing/campaign/getInfoByIdList'
返回结果
{
"campaignList": [
{
"id": 3924246343,
"name": "022701",
"budget": "0.00",
"region": "[\"0\"]",
"schedule": [
{
"week": 1,
"hour": [1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]
},
{
"week": 2,
"hour": [0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]
}
],
"hasServiceRatio":"1",
"planServiceRatio":[[1,0,1.6],[1,1,1.9],[2,3,2.6]],
"startDate": "2019-02-27",
"endDate": "2021-11-11",
"addTime": "2019-02-27 14:29:20",
"updateTime": "2019-02-27 14:29:20",
"device": "0",
"status": "enable",
"negtiveWords": [],
"exactNegtiveWords": [],
"extendAdType": "[\"biyi\",\"mobile\"]",
"mobilePriceRate": "100",
"mobilehq_premium": 1.8,
"mobilehq_switch": 1
},
{
"id": 3924245063,
"name": "客户端上来的",
"budget": "0.00",
"region": "[\"0\"]",
"schedule": [
{
"week":1,
"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]
},
{
"week": 2,
"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]
},
{
"week": 3,
"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]
},
{
"week": 4,
"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]
},
{
"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]
},
{
"week": 6,
"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]
},
{
"week": 7,
"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]
}
],
"hasServiceRatio":"0",
"planServiceRatio":[],
"startDate": "2019-02-27",
"endDate": "2021-11-11",
"addTime": "2019-02-27 14:55:41",
"updateTime": "2019-02-27 14:55:41",
"device": "0",
"status": "enable",
"negtiveWords": [],
"exactNegtiveWords": [],
"extendAdType": "[\"biyi\",\"mobile\"]",
"mobilePriceRate": "100",
"mobilehq_premium": 10,
"mobilehq_switch": 1
},
{
"id": 3907501127,
"name": "update_计划名称_auto_exec",
"budget": "230.00",
"region": "[\"0\"]",
"schedule": [
{
"week":1,
"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]
},
{
"week": 2,
"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]
},
{
"week": 3,
"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]
},
{
"week": 4,
"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]
},
{
"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]
},
{
"week": 6,
"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]
},
{
"week": 7,
"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]
}
],
"hasServiceRatio":"0",
"planServiceRatio":[],
"startDate": "2019-03-05",
"endDate": "2030-03-05",
"addTime": "2019-03-05 11:24:39",
"updateTime": "2019-03-05 12:38:39",
"device": "0",
"status": "pause",
"negtiveWords": [
"短语匹配1"
],
"exactNegtiveWords": [
"精确1",
"精确2"
],
"extendAdType": "[\"biyi\",\"mobile\"]",
"mobilePriceRate": "70",
"searchIntention": "open",
"mobilehq_premium": 5.2,
"mobilehq_switch": 0
}
]
}
返回结果说明
字段 |
类型 |
描述 |
id |
int |
推广计划id |
name |
string |
推广计划名称 |
budget |
string |
推广计划每日预算 |
region |
string |
投放地域 |
searchIntention |
string |
搜索意图定位 |
schedule |
json |
投放时间段 |
startDate |
string |
推广计划开始日期 |
endDate |
string |
推广计划结束日期 |
status |
string |
推广计划状态,enable/pause |
addTime |
string |
推广计划创建时间 |
updateTime |
string |
推广计划最后更新时间 |
mobilePriceRate |
string |
移动出价比例, mobilePriceRate只能是10的整数倍, 出价比例区间为20-990,若该值为300, 则表示移动端出价为PC端出价的300%.关键词的移动出价低于0.3 时,系统使用0.3进行竞价 |
negtiveWords |
json |
短语匹配的否定关键词 |
exactNegtiveWords |
json |
精确匹配的否定关键词 |
device |
string |
计划投放设备. 0 表示投放PC 端和移动端.1 表示仅投放移动端 |
extendAdType |
string |
计划扩展字段 |
hasServiceRatio |
int |
分时段出价开关,0关闭,1开启 |
planServiceRatio |
Json |
投放时段系数,格式为[[week,hour,ratio],[week,hour,ratio]] |
mobilehq_switch |
int |
移动优质流量时段投放开关,0-关闭,1-开启 |
mobilehq_premium |
double |
移动优质流量溢价系数(支持一位小数),范围:1.0~10.0 |