华为的广告推广：规划投放（上）

优化师-老杨

2个月前发布

0365

华为广告推广投放计划

创建计划

利用此接口能够创建计划。

请求地址：https://ads.cloud.huawei.com/openapi/v2/promotion/campaign/create

请求方法：POST

请求参数

参数名称	类型	是否必选	描述
campaign_name	string	是	计划名称需满足正则表达式“regexp=^[^^\|]+$”，最大长度不超过 50 ，且计划名称不得重复。
product_type	string	是	推广产品，详见【推广产品】。
daily_budget	integer	是	日限额，当日限额与次日限额均为此值，整数位数长度不得超过 9 位，日限额不得低于最小日限额，现网最小日限额为 500 ，现阶段最小日限额为 30 。

请求示例

==========================================================================================================

POST

/openapi/v2/promotion/campaign/create HTTP/1. 1

Accept:application/json

Content-Type:application/json

Authorization：

Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=

{

“campaign_name”:”信息流小图计划 0510″,

“product_type”:”WEB”,

“daily_budget”:500

}

==========================================================================================================

响应字段

参数名称	类型	是否必选	描述
code	string	是	返回码，200 表示成功，其他则为失败。
message	string	否	返回描述
data	Struct1	否	计划 ID

data(Struct1)定义

参数名称	类型	是否必选	描述
campaign_id	string	是	计划 ID

应答示例

==========================================================================================================

HTTPS/1. 1 200 OK

{

“code”: 200,

“data”:{

“campaign_id”: “35003379”

}

==========================================================================================================

2、查询计划

通过此接口能够查询计划。

请求地址：https://ads.cloud.huawei.com/openapi/v2/promotion/campaign/query

请求方法：GET

请求参数

参数名称	类型	是否必选	描述
page_num	integer	是	搜索页码，取值范围为 1 至 10000 。
page_size	integer	是	一页展示数量，取值范围为 10 至 50 。
以下为过滤字段
campaign_name	string	否	计划名称，最大长度不超过 50 ，需满足正则表达式“regexp=^[^^\|]+$”。
campaign_ids	string[]	否	推广计划 ID 列表，最多 100 个。
updated_begin_time	string	否	计划更新的开始时间，格式为：”yyyy-MM-dd HH:mm:ss”。
updated_end_time	string	否	计划更新的结束时间，格式为：”yyyy-MM-dd HH:mm:ss”。

请求示例

GET

/openapi/v2/promotion/campaign/query?page_num=1&page_size=11&campaign_ids=35006441 HTTP/1.1

Accept:application/json

Content-Type:application/json

Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=

响应字段

参数名称	类型	是否必选	描述
code	string	是	返回码
message	string	否	返回描述
data	Struct1	否	计划列表

data(Struct1)定义

参数名称	类型	是否必选	描述
total	integer	是	总条数
data	Struct2[]	否	计划列表

data(Struct2)定义

参数名称	类型	是否必选	描述
campaign_name	string	是	计划名称
campaign_id	string	是	计划 ID
campaign_status	string	是	操作状态，详见【计划/任务/创意操作状态】。
campaign_daily_budget_status	string	是	计划日限额状态，详见【计划日限额状态】。
user_balance_status	string	是	账户余额状态，详见【账户余额状态】。
product_type	string	是	推广产品，计划的 product_type 与关联推广产品的 product_type 需要保持一致，详见【推广产品】。
tomorrow_daily_budget	integer	否	次日计划日限额，不返回表示与当日计划日限额相同，详见【日限额说明】。
today_daily_budget	integer	是	当日计划日限额，详见【日限额说明】。

应答示例

=========================================================================================================

HTTPS/1.1 200 OK

{

“code”: “200”,

“data”:{

“total”: 1210,

“data”: [{

“campaign_name”: “美丽传说营销节”,

“product_type”: “ANDROID_APP”,

“user_balance_status”: “ADVERTISER_BALANCE_NOT_EXCEED”,”campaign_status”: “OPERATION_STATUS_ENABLE”,”campaign_daily_budget_status”: “CAMPAIGN_DAILY_BUDGET_NOT_EXCEED”,”show_status”: “CAMPAIGN_STATUS_DELIVERY_OK”,

“campaign_id”: “35002310”,

“today_daily_budget”: “40”

{

“campaign_name”: “憧憬人生”,

“product_type”: “ANDROID_APP”,

“user_balance_status”: “ADVERTISER_BALANCE_NOT_EXCEED”,”campaign_status”: “OPERATION_STATUS_ENABLE”,”campaign_daily_budget_status”: “CAMPAIGN_DAILY_BUDGET_NOT_EXCEED”,

“campaign_id”: “35002309”,

“today_daily_budget”: “200”

}]

}

=========================================================================================================

3、编辑计划状态

通过此接口能够编辑计划状态。

请求地址：https://ads.cloud.huawei.com/openapi/v2/promotion/campaign/status/update

请求方法：POST

请求参数

参数名称	类型	是否必选	描述
campaign_id	string	是	计划 ID ，长度为 1 到 50 ，需满足正则表达式“^[A-Za-z0-9]*$”。
op_type	string	是	操作类型，当操作类型为开始或者暂停时：竞价只支持未删除；当操作类型为删除时：计划状态不能为已删除，90 天无数据，则计划将被删除。有数据无法被删除。原状态为删除，不可更新。启动操作需要保证计划原状态是暂停状态，详见【操作类型】。