提交异步任务

所属权限 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[] 警示语文本列表

使用说明

  1. 招商加盟服务:创业/投资/市场有风险(适用于图片、视频)。
  2. 互联网内容资讯服务-阅读与在线 FM 收听、互联网内容资讯服务-在线视频平台、数字内容创作-数字小说创作、数字内容创作-其他视频内容、数字传媒内容-在线阅读、数字传媒内容-在线短剧、数字媒体平台-在线视频平台:内容虚构,请树立正确价值观(适用于图片、视频)。
  3. 家装家具、家装建材:具体价格以实际装修方案为准(适用于图片、视频)。
  4. 金融-地方小额贷款、金融-网络小额贷款、金融-助贷平台、金融-消费金融、金融-贷款服务、金融-银行服务:贷款有风险,借款需谨慎(适用于图片、视频);贷款额度/放款时间等以实际审批为准(适用于图片、视频);具体金额以实际审批为准(适用于图片);系视频创意,微信使用年限仅为借款人信用评估佐证因子(适用于视频);公积金相关资料仅作为贷款服务验资证明,放贷路径与公积金账户无关(适用于图片、视频);信用分以实际评估为准(适用于图片、视频);视频为情节演绎(适用于视频);年化利率(单利)X%-X%(适用于图片、视频);年化利率(复利)X%-X%(适用于图片、视频);(X 替换为小数,精确到小数点后两位,取值范围[0-24])。
  5. 护肤彩妆、个人护理、美妆个护-普通化妆品、美妆个护-美妆工具、美妆个护-特殊化妆品-护肤、美妆个护-特殊化妆品-护发、美妆个护-特殊化妆品-美体、美妆个护-个人护理:使用效果因人而异(适用于视频)。
  6. 日用百货-家庭清洁用品、文娱用品-文具及办公用品、文娱用品-乐器、生活日用-宠物用品、生活日用-成人用品、生活日用-居家日用、生活日用-家庭清洁试剂、美妆个护-私密护理、园艺农资-花卉绿植:视频已经过加速处理,效果仅供参考(适用于视频)。
  7. 食品、食品饮料- 饮料冲调:本产品不能代替特殊医学用途配方食品、婴幼儿配方食品、保健食品等特殊食品(适用于图片、视频)。
  8. 服饰鞋帽箱包-贴身衣物、服饰珠宝-贴身衣物:开包不可退(适用于图片、视频);不影响二次销售可退换(适用于图片、视频)。

请求示例


curl 'https://api.e.qq.com/v3.0/material_async_tasks/add?access_token=<ACCESS_TOKEN>&timestamp=<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"
    }
}

可视化调试工具