快速入门指南
术语阐释
|
术语 |
中文名 |
详细说明 |
|
HUAWEI Ads |
华为广告推广服务 |
/ |
|
客户端ID |
HUAWEI ADS Marketing API客户端ID |
HUAWEI ADS Marketing API客户端指的是通过HUAWEI ADS Marketing API获取数据的软件系统。 |
|
秘钥 |
客户端密钥 |
每一个客户端对应的密钥（用于后续获取access_token）。 |
|
scope |
授权作用域 |
用户授予的权限列表 |
|
redirect_uri |
回调uri |
授权完成后要回调的URI，也就是接收Authorization Code或者token后的跳转url |
|
access_token |
授权令牌 |
使用/oauth2/v2/token接口时会同时获取access_token。access_token是调用API接口的调用凭证，用于服务端对API请求进行鉴权，默认有效期为1小时，一旦access_token失效，就需要重新获取。 |
功能全景展示
开户、实名认证、行业资质等操作请在华为广告投放平台进行。
推广和报表接口通过Marketing API对外开放，但在使用过程中，部分依赖的接口尚未对外开放，需要在华为投放平台创建后才能在Marketing API中使用。
|
分类 |
子分类 |
接口 |
Marketing API是否支持 |
|
广告投放 |
计划 |
创建计划 /v2/promotion/campaign/create |
是 |
|
查询计划 /v2/promotion/campaign/query |
是 |
||
|
编辑计划状态 /v2/promotion/campaign/status/update |
是 |
||
|
编辑计划名称 /v2/promotion/campaign/name/update |
是 |
||
|
编辑计划日限额 /v2/promotion/campaign/daily_budget/update |
是 |
||
|
任务 |
创建任务 /v2/promotion/adgroup/create |
是 |
|
|
查询任务 /v2/promotion/adgroup/query |
是 |
||
|
编辑任务 /v2/promotion/adgroup/update |
是 |
||
|
编辑任务状态 /v2/promotion/adgroup/status/update |
是 |
||
|
编辑任务投放日期 /v2/promotion/adgroup/time/update |
是 |
|
编辑任务时间段 /v2/promotion/adgroup/period/update |
是 |
||
|
编辑任务出价 /v2/promotion/adgroup/price/update |
是 |
||
|
编辑任务名称 /v2/promotion/adgroup/name/update |
是 |
||
|
编辑任务期望出价(oCPC) /v2/promotion/adgroup/conversion_cost/update |
是 |
||
|
查询应用详情 /v2/promotion/adgroup/app_detail/query |
是 |
||
|
查询定向字典 /v2/promotion/adgroup/targeting_rule/query |
是 |
||
|
查询关联的定向包详情 /v2/promotion/adgroup/targeting_package/query |
是 |
||
|
创意 |
创建创意 /v2/promotion/creative/create |
是 |
|
|
查询创意 /v2/promotion/creative/query |
是 |
||
|
编辑创意 /v2/promotion/creative/update |
是 |
||
|
编辑创意状态 /v2/promotion/creative/status/update |
是 |
||
|
编辑创意名称 /v2/promotion/creative/name/update |
是 |
||
|
推广产品 |
创建推广产品 /v2/promotion/product/create |
是 |
|
|
查询推广产品 /v2/promotion/product/detail/query |
是 |
||
|
编辑推广产品 /v2/promotion/product/update |
是 |
||
|
工具箱 |
版位 |
查询版位 /v2/tools/position/query |
是 |
|
查询版位元素 /v2/tools/position/detail/query |
是 |
||
|
维纳斯落地页 |
查询落地页 /v2/tools/venus/active_page/query |
是 |
|
|
落地页增、删、改 |
否 |
||
|
渠道包 |
查询渠道包 /v2/tools/channel_package/active_package/query |
是 |
|
|
渠道包增、删、改 |
否 |
||
|
素材管理 |
创建素材 /v2/tools/creative_asset/create |
是 |
|
|
查询素材 /v2/tools/creative_asset/query |
是 |
||
|
编辑素材名称 /v2/tools/creative_asset/name/update |
是 |
||
|
获取文件上传凭证 /v2/tools/file/token/query |
是 |
||
|
删除素材 /v2/tools/creative_asset/delete |
是 |
||
|
定向模板 |
创建定向模板 /v2/tools/targeting_template/create |
是 |
|
|
查询定向模板 /v2/tools/targeting_template/query |
是 |
||
|
定向模板改、删 |
否 |
||
|
转化跟踪指标 |
查询转化跟踪指标 /v2/tools/effect_tracking/query |
是 |
|
|
转化跟踪指标增、删、改 |
否 |
刷新access_token
使用RefrestToken获取新的AccessToken。建议在AccessToken即将过期时调用。
调用业务接口，如果返回的code如下：
=========================================================================================================
{
“code”: “1000009992”,
“message”: “token已过期”
}
=========================================================================================================
请调用刷新access_token接口，重新获取一次access_token，如果仍然失败，将用户登出，引导用户重新登录。
请求消息
客户端：广告主服务器
服务端：Huawei帐号服务器
请求协议：HTTPS
请求方式：POST
接口URL：
https://login.cloud.huawei.com/oauth2/v2/token
请求参数
|
参数名称 |
类型 |
是否必选 |
描述 |
|
grant_type |
string |
是 |
RT换AT场景，固定填写：refresh_token |
|
refresh_token |
string |
是 |
在授权码模式下获取到的refresh_token值 |
|
client_id |
int |
是 |
必须与调用/oauth2/v2/authorize接口时传递的client_id相同 |
|
client_secret |
string |
是 |
Appid的密钥，在开发者联盟上查看 |
请求示例
===================================================================
======================================
POST /oauth2/v2/token HTTP/1.1
Host: login.cloud.huawei.com
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&am
![图片[1]-华为广告推广：轻松上手-精准获客](https://cos.jingzhunhuoke.net/tu/suolue/10.jpg)
p;client_id=12345&client_secret=bKaZ*************d2k9few&refresh_token=CF2Mm03n0aos9iZZ8nIhfyDtoXy74CXeBi50gVVhMpB0IUzlv9ZwizEvTBhVoF820ZPim0JwNR9j2p1qgEQWnIVYZRlp******gekUnsHBkvNev5rd2MdfQMLP
=========================================================================================================
响应参数
|
参数名称 |
类型 |
是否必选 |
描述 |
|
access_token |
string |
是 |
AccessToken。使用时注意去掉\这个转义字符。 |
|
expires_in |
integer |
是 |
AccessToken的有效期，以秒为单位 |
|
refresh_token |
string |
是 |
用于刷新AccessToken的Refresh Token，有效期半年（OAuth可能会调整此配置） 。 如果在服务器配置了返回RT，则服务器一定会返回该字段。返回的值可能是新的refresh_token，新的refresh_token有效期仍为半年；也可能与入参的refresh_token相同。 |
|
scope |
string |
是 |
AccessToken最终的访问范围，即用户实际授予的权限列表（用户在授权页面时，可能会取消某些请求的权限） |
成功响应消息示例：
=========================================================================================================
HTTP/1.1 200 OK
Content-Type: text/html;charset=UTF-8
Cache-Control: no-store
{“access_token”:”CFyJ4J\/l6wuwcFqYOJG4maq2ca8RAV+g0i+mel6qCV5lvqH0PYtW0+BNwfHWg0AqMnW6ZdBvUgs7ijkxMFh1xVP\/B+vQXz3PWsivkKCuL78XtbLt7vs=”,”expires_in”: 3600,”scope”: “https:\/\/www.huawei.com\/auth\/account\/base.profile”,”token_type”: “Bearer”}
===================================================================
======================================
注意：
json字符串中存在转义符。如果用curl命令或者postman工具手工获取access_token，将“\/”还原为“/”才是正确
2 本站部分内容来源于网络，仅供学习与参考，如有侵权，请联系网站管理员删除
3 本站一律禁止以任何方式发布或转载任何违法的相关信息，访客发现请向站长举报
4 精准获客感谢您的访问！希望本站内容对您有所帮助！
暂无评论内容