提交异步任务
| 所属权限 | ads_management |
| 请求地址 | material_async_tasks/add |
| 请求方法 | POST |
| Content-Type | application/json |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考。
| 参数名称 | 参数类型 |
|---|---|
| access_token | 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节 |
| timestamp |
当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59 |
| nonce | 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性 |
请求参数
标有*的参数为必填项
| 名称 | 类型 | 描述 |
|---|---|---|
|
account_id
|
integer | 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id |
|
organization_id
|
integer | 业务单元 id 最小值 0,最大值 9999999999 |
|
material_param_type*
|
enum | 素材传参类型,[枚举详情] 可选值:{ MATERIAL_PARAM_TYPE_ID } |
|
material_type*
|
enum | 素材类型,[枚举详情] 可选值:{ IMAGE, VIDEO } |
|
material_detail*
|
struct[] | 素材详情列表,数组最小长度 1,最大长度 100 |
|
material_id
|
string | 素材 id,material_param_type 为 MATERIAL_PARAM_TYPE_ID 时必填 |
|
task_specs*
|
struct | 任务规格配置 |
|
watermark_spec
|
struct | 警示语任务配置 |
|
text*
|
string[] | 警示语文本列表 |
使用说明
- 招商加盟服务:创业/投资/市场有风险(适用于图片、视频)。
- 互联网内容资讯服务-阅读与在线 FM 收听、互联网内容资讯服务-在线视频平台、数字内容创作-数字小说创作、数字内容创作-其他视频内容、数字传媒内容-在线阅读、数字传媒内容-在线短剧、数字媒体平台-在线视频平台:内容虚构,请树立正确价值观(适用于图片、视频)。
- 家装家具、家装建材:具体价格以实际装修方案为准(适用于图片、视频)。
- 金融-地方小额贷款、金融-网络小额贷款、金融-助贷平台、金融-消费金融、金融-贷款服务、金融-银行服务:贷款有风险,借款需谨慎(适用于图片、视频);贷款额度/放款时间等以实际审批为准(适用于图片、视频);具体金额以实际审批为准(适用于图片);系视频创意,微信使用年限仅为借款人信用评估佐证因子(适用于视频);公积金相关资料仅作为贷款服务验资证明,放贷路径与公积金账户无关(适用于图片、视频);信用分以实际评估为准(适用于图片、视频);视频为情节演绎(适用于视频);年化利率(单利)X%-X%(适用于图片、视频);年化利率(复利)X%-X%(适用于图片、视频);(X 替换为小数,精确到小数点后两位,取值范围[0-24])。
- 护肤彩妆、个人护理、美妆个护-普通化妆品、美妆个护-美妆工具、美妆个护-特殊化妆品-护肤、美妆个护-特殊化妆品-护发、美妆个护-特殊化妆品-美体、美妆个护-个人护理:使用效果因人而异(适用于视频)。
- 日用百货-家庭清洁用品、文娱用品-文具及办公用品、文娱用品-乐器、生活日用-宠物用品、生活日用-成人用品、生活日用-居家日用、生活日用-家庭清洁试剂、美妆个护-私密护理、园艺农资-花卉绿植:视频已经过加速处理,效果仅供参考(适用于视频)。
- 食品、食品饮料- 饮料冲调:本产品不能代替特殊医学用途配方食品、婴幼儿配方食品、保健食品等特殊食品(适用于图片、视频)。
- 服饰鞋帽箱包-贴身衣物、服饰珠宝-贴身衣物:开包不可退(适用于图片、视频);不影响二次销售可退换(适用于图片、视频)。
请求示例
curl 'https://api.e.qq.com/v3.0/material_async_tasks/add?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
"account_id": "<ACCOUNT_ID>",
"material_param_type": "MATERIAL_PARAM_TYPE_ID",
"material_type": "IMAGE",
"material_detail": [
{
"material_id": "123"
}
],
"task_specs": {
"watermark_spec": {
"text": [
"开包不可退"
]
}
}
}'
应答字段
| 名称 | 类型 | 描述 |
|---|---|---|
|
job_id
|
string | 任务 Job id,用于查询任务状态 |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"job_id": "949cb7b5-5249-4ab8-a27e-d2ae081137f8"
}
}
可视化调试工具
问题仍未解决?
请前往腾讯广告反馈中心在线提交问题,我们的人工客服将为你服务