批量查询推广计划
HTTP请求方式
GET
请求地址
Headers 请求参数
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
Content-Type | string | yes | application/x-www-form-urlencoded |
apiKey | string | yes | 注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken | string | yes | 访问token |
Body 请求参数
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
campaignIds | string | yes | 推广计划ID,英文逗号分隔,如果输入超过100,全部不处理 |
status | integer | yes | 计划启用/暂停 枚举值:1-启用,0-暂停,如不填则默认返回所有启用和暂停的计划 |
请求示例
curl --location --request GET 'http://localhost:8076/display/campaign/Getinfobyid?campaignIds=5013360,5013360' \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN'
返回结果
{
"data": [
{
"id": 5013360,
"errno": 2000000,
"message": "成功",
"name": "我是一个新的计划名称",
"ocpc_flag": "0",
"enabled": "1",
"status": "6",
"budget": "100",
"equal_budget_flag": "1",
"budget_limited_alert": "1",
"audit_refused_warn_flag": "0",
"start_date": "2023-12-29",
"end_date": "2030-12-31",
"week": {
"1": "000111111111111111111111111111111111111111111111",
"2": "111111111111111111111111111111111111111111111111",
"3": "111111111111111111111111111111111111111111111111",
"4": "111111111111111111111111111111111111111111111111",
"5": "111111111111111111111111111111111111111111111111",
"6": "111111111111111111111111111111111111111111111111",
"7": "111111111111111111111111111111111111111111111111"
}
}
],
"errmsg": "OK",
"errno": 0
}
返回结果说明
字段 | 类型 | 描述 |
---|---|---|
id | integer | 推广计划ID |
name | string | 推广计划名称 |
ocpc_flag | string | 是否为oCPX计划 枚举值:0-否,1-标准oCPC(需转化收集),2-oCPM计划(需收集转化),3-放量投放计划(需收集转化) |
bid_policy | string | 模式选择,仅当是否为oCPX计划为标准版oCPC、oCPM计划时返回 枚举值:0-代码监测,1-建站工具,2-API对接 |
order_source | string | 数据来源,仅当是否为oCPX计划为标准版oCPC、oCPM计划、放量投放计划时返回 枚举值:0-代码监测,1-建站工具,2-API对接 |
order_type | string | 转化类型,仅当是否为oCPX计划为标准版oCPC、oCPM计划、放量投放计划时返回 枚举值:根据数据来源判断转化类型,具体请查看表格 |
order_price | string | 目标转化成本,单位:元,仅在是否为oCPX计划为标准版oCPC、oCPM计划时返回 |
cpm_price | string | CPM出价,单位:元,仅在是否为oCPX计划为oCPM计划时返回 |
cpc_price | string | CPC出价,单位:元,仅在是否为oCPX计划为oCPC计划时返回 |
order_success_url | string | 转化成功页地址 URL,在是否为oCPX计划为否、或标准版oCPC、oCPM计划、放量投放计划的转化类型为快投放且不为空时返回,多个url用英文逗号分隔 |
accelerate_consume_flag | string | 一键起量,仅在是否为oCPX计划为标准版oCPC、oCPM计划时返回 枚举值:0-关闭,1-开启 |
enabled | string | 计划启用/暂停 枚举值:0-暂停,1-开启 |
status | string | 计划状态 枚举值:1-投放中,2-在等待,3-已暂停,4-已删除,5-已结束,6-预算受限,7-广告主暂停,8-广告主被拒绝,9-广告主试用中,10-广告主余额不足,11-账户预算受限 |
budget | string | 每日预算,单位:元 |
equal_budget_flag | string | 预算分配控制,仅在是否为oCPX计划为否时返回;枚举值:0-标准:将每日预算均匀地分配到整个投放日程中,1-尽速:在投放日程中尽可能地获得更多的展现(建议与精准定向配合使用) |
budget_limited_alert | string | 预算受限提醒 枚举值:0-否,1-是 |
audit_refused_warn_flag | string | 创意审核拒登提醒 枚举值:0-否,1-是 |
start_date | string | 开始时间 格式:YYYY-MM-DD |
end_date | string | 结束时间 格式:YYYY-MM-DD |
week | object | 小时投放,例如:"week": {"1": "001111111111111111111111111111111111111111111111","2": "111111111111111111111111111111111111111111111111","3":"111...",...,"7": "111111111111111111111111111111111111111111111111"}, |