华为广告推广-编辑任务
通过此接口可以编辑任务
请求地址
https://ads.cloud.huawei.com/openapi/v2/promotion/adgroup/update
请求方法
POST
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
adgroup_id | long | 是 | 任务 ID |
adgroup_name | string | 是 | 任务名称必填,最大长度不得 超 128,不能使用“^”,“|”特 殊字符,不能重名 |
channel_package_id | string | 否 | 渠道包 ID 详见【创建渠道包】 |
targeting_template_id | long | 否 | 定向模板 ID,不填表示不更新 定向; 即创建定向模板接口中返回的 targeting_template_id; 注:非 APP 的推广产品不能有 APP 安装定向; 定向模板仅用于创建广告时快 捷选择定向条件;编辑定向模 板,不会自动将定向内容同步 到与此定向模板相关联的广告 中。 详见【创建定向模板】 |
adgroup_begin_time | string | 是 | 投放开始日期,格式:YYYY- MM-DD 如: 2020-01-01 注:原始开始时间小于当前时 间并且原始结束时间大于当前 时间,说明任务已经开始,不 能修改开始时间,只能修改结 束时间; 修改的开始时间不能早于当 天。 |
adgroup_end_time | string | 否 | 投放结束日期,格式:YYYY- MM-DD,为空表示长期投投放 |
如: 2020-01-02 注:结束时间不能早于开始时 间,也不能早于当前时间;原 始结束时间小于当前时间说明 任务已经结束,不能修改任何 时间 | |||
time_period_type | string | 是 | 时间段类型,可以从三种类型 中根据自己需要选择一个。 time_period 为空时, 时间段类 型不得为 TIME_PERIOD_DAY_SPECIFI C 或 TIME_PERIOD_HOUR_SPECIF IC 详见【时间段类型】 |
time_period | string | 否 | ttime_period_type 为 TIME_PERIOD_DAY_SPECIFI C、 TIME_PERIOD_HOUR_SPECIF IC 时必填。 按照特定时间段投放时, 01010100010010……表示指定 特殊时段, 半小时为粒度,用 0 、1 标识是否选中, 1 为选 中, 0 为未选中。一天 24 小 时,即每天 24*2=48 位,共 7 天,即共 48*7=336 位 如果 time_period_type 为 TIME_PERIOD_ALL,则表示 一周内每天的特定小时,需要 每 48 个值都重复。 注:时间段要与任务的日期区 间有交集。 例:如果任务开始时间是 2020- 06-22 (周一), 结束时间是 2020-06-24 (周三) ,且选择的 类型是 TIME_PERIOD_DAY_SPECIFI C 或 TIME_PERIOD_HOUR_SPECIF IC,那 time_period 的入参需要 与任务的时间段有交集;若用 户想在 22/23/24 的每天早上 6 点到 9 点投放任务, 则 time_period 的参数可表示为 00000000000011111100… |
0000…(共 336 位) | |||
price | float | 是 | 出价 整数位不得超过 9 位,小 数位不得超 2 位; 注:范围在此任务中对应的版 位的 CPM 最低售价和对应的计 划中的日限额之间。 |
conversion_cost | float | 否 | 期望转化成本, price_type 为 PRICING_OCPC 时专用 暂支持 app 和网页 整数位不得超过 9 位,小数位 不得超 2 位 |
channel_info | string | 否 | 转化跟踪参数 不得超 1024 位 |
dyn_price_flag | string | 否 | 智能提价标志 仅当推广产品为 ANDROID_APP 且定向模板中 installed_apps_struct 值为 true 时 有效 详见【智能提价标志】 |
dyn_price_upper_limit | float | 否 | dyn_price_flag 为 DYNAMIC_PRICE_ENABLE 时 必填 智能提价上限,范围在 1 到 10 之间, 整数位不得超过 2 位,小数位 不得超 1 位 |
请求示例
=================================================================== =======================================POST
openapi/v2/promotion/adgroup/update HTTP/1. 1
Accept:application/json
Content-Type:application/json
Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=
{
"adgroup_id": 45002610,
"adgroup_name": "XXXXX",
"targeting_template_id": 65002018,
"adgroup_begin_time": "2020-05-20",
"adgroup_end_time": "2020-05-23",
"price": 80
}
===================================================================
=======================================
响应字段
参数名称 | 类型 | 是否必选 | 描述 |
code | string | 是 | 返回码 |
message | string | 否 | 返回描述 |
data | Struct1 | 否 | 任务 ID |
data(Struct1)定义
参数名称 | 类型 | 是否必选 | 描述 |
adgroup_id | long | 是 | 任务 ID |
应答示例
=================================================================== ======================================
HTTPS/1. 1 200 OK
{
"code": "200",
"data": {
"adgroup_id": 45002610
}
}
=================================================================== =======================================
编辑任务状态
通过此接口可以批量编辑任务状态
请求地址
https://ads.cloud.huawei.com/openapi/v2/promotion/adgroup/status/update
请求方法
POST
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
adgroup_ids | long[] | 是 | 任务 ID 数组,最大 50 个任务 id |
op_type | string | 是 | 操作类型 注: 1.如果任务已是删除状态, 则会 提示任务已删除,不可更新操 作; 2.任务下无审核通过的有效素 材,不能进行修改任务状态操 作; 3.已结束的任务不支持修改状态 操作; 4.启动操作需要保证任务原状态 是暂停状态 5.暂停操作需要保证任务是启动 状态。 详见【操作类型】 |
请求示例
=================================================================== ======================================
POST /openapi/v2/promotion/adgroup/status/update HTTP/1. 1
Accept:application/json
Content-Type:application/json
Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=
{
"adgroup_ids":[3002205],
"op_type":"OPERATION_ENABLE"
}
=================================================================== ======================================
响应字段
参数名称 | 类型 | 是否必选 | 描述 |
code | string | 是 | 返回码 |
message | string | 否 | 返回描述 |
data | Struct1 | 否 | 编辑失败的任务列表 |
data(Struct1)定义
参数名称 | 类型 | 是否必选 | 描述 |
error_info_list | Struct2[] | 是 | 编辑失败的任务列表 |
error_info_list(Struct2)定义
参数名称 | 类型 | 是否必选 | 描述 |
id | long | 是 | 错误 ID |
code | integer | 是 | 错误结果码 |
message | string | 否 | 错误描述 |
应答示例
=================================================================== ======================================
HTTPS/1. 1 200 OK
{
"code":"200"
}
=================================================================== ======================================
编辑任务投放日期
通过此接口可以编辑任务投放日期
请求地址
https://ads.cloud.huawei.com/openapi/v2/promotion/adgroup/time/update
请求方法
POST
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
adgroup_time_list | Struct1[] | 是 | 待更新任务日期列表,数组最大 50 |
adgroup_time_list(Struct1)定义
参数名称 | 类型 | 是否必选 | 描述 |
adgroup_id | long | 是 | 任务 ID |
adgroup_begin_time | string | 是 | 投放开始日期,格式:YYYY- MM-DD 如: 2020-01-01 注:原始开始时间小于当前时间 并且原始结束时间大于当前时 间,说明任务已经开始,不能修 改开始时间,只能修改结束时 间; 修改的开始时间不能早于当, 并 且开始时间和结束时间差值需要 在 5.1.1 查询版位获得的投放此 版位的任务最短和最长投放时间 范围之内。 |
adgroup_end_time | string | 是 | 投放结束日期,格式:YYYY- MM-DD,为空表示长期投投放 如: 2020-01-02 注:结束时间不能早于开始时 间,也不能早于当前时间;原始 结束时间小于当前时间说明任务 已经结束, 不能修改任何时间 |
请求示例
=================================================================== ======================================
POST /openapi/v2/promotion/adgroup/time/update HTTP/1. 1
Accept:application/json
Content-Type:application/json
Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=
{
"adgroup_time_list":[{
"adgroup_id": 3001825,
"adgroup_begin_time": "2019-08- 12",
"adgroup_end_time": "2020-08- 12"
}]
}
===================================================================
=======================================
响应字段
参数名称 | 类型 | 是否必选 | 描述 |
code | string | 是 | 返回码 |
message | string | 否 | 返回描述 |
data | Struct1 | 否 | 编辑失败的任务列表 |
data(Struct1)定义
参数名称 | 类型 | 是否必选 | 描述 |
error_info_list | Struct2[] | 是 | 编辑失败的任务列表 |
error_info_list(Struct2)定义
参数名称 | 类型 | 是否必选 | 描述 |
id | long | 是 | 错误 ID |
code | integer | 是 | 错误结果码 |
message | string | 否 | 错误描述 |
应答示例
=================================================================== ======================================
HTTPS/1. 1 200 OK
{
"code":"200"
}
=================================================================== ======================================
以上就是华为广告推广-任务编辑的文章内容,编辑任务内容投放日期时间段等等将与投放产品息息相关,设置人群也相同,如果您在操作账户设置任务内容遇到什么问题可以咨询巨宣网络,巨宣网络将免费手把手教您如何搭建计划!
- 2024-10-12
金投赏鲸鸿动能专场,华为广告全场景释放数… - 2024-09-23
华为广告大卡智投支持oCPD,强势助力品效合… - 2024-09-23
冲量黄金周—华为广告鲸鸿动能国庆投放指南… - 2024-09-12
如何1分钟玩转华为广告AI大模型微调推理?… - 2024-09-07
共创价值·赋能增长:携手影娱/资讯/教育行… - 2024-08-22
2024 CDEC高峰论坛:鸿蒙生态技术赋能 构筑… - 2024-08-20
华为广告携手某炒股软件,首次解锁「智慧多… - 2024-08-17
华为广告开户流程和广告计费、展示、形式有… - 2024-08-13
鲸鸿动能五大行业解决方案发布,以生态力量… - 2024-04-11
华为广告 | “低代码开发实践分享:共创未…
管理员
该内容暂无评论