批量获取推广计划信息


HTTP请求方式

POST

请求地址

https://api.e.360.cn/dianjing/campaign/getInfoByIdList

Headers请求参数
字段 类型 必须 描述
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", //0未开启,1开启
            "planServiceRatio":[[1,0,1.6],[1,1,1.9],[2,3,2.6]], //[[week,hour,ratio],[week,hour,ratio]]
            "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", //0未开启,1开启
            "planServiceRatio":[], //数组空表示未开启投放时段出价,[[week,hour,ratio],[week,hour,ratio]]
            "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", //0未开启,1开启
            "planServiceRatio":[], //数组空表示未开启投放时段出价,[[week,hour,ratio],[week,hour,ratio]]
            "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

results matching ""

    No results matching ""