华为广告推广 – 编辑任务
此接口能够用于编辑任务。
请求地址
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 注：结束时间不能早于开始时间，也不能早于当前时间；原始结束时间小于当前时间说明任务已经结束，不能修改任何时间 |
|
如： 2020-01-02 注：结束时间不能早于开始时间，也不能早于当前时间；原始结束时间小于当前时间说明任务已经结束，不能修改任何时间 |
|||
|
time_period_type |
string |
是 |
时间段类型，可以从三种类型中根据自身需要选择一个。 time_period 为空时，时间段类型不得为 TIME_PERIOD_DAY_SPECIFIC 或 TIME_PERIOD_HOUR_SPECIFIC 详见【时间段类型】 |
|
time_period |
string |
否 |
ttime_period_type 为 TIME_PERIOD_DAY_SPECIFIC、 TIME_PERIOD_HOUR_SPECIFIC 时必填。 按照特定时间段投放时，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_SPECIFIC 或 TIME_PERIOD_HOUR_SPECIFIC，那 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/updateHTTP/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/updateHTTP/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 |
否 |
暂无评论内容