文档中心 > API类目 > 阿里妈妈-UniDesk

taobao.unidesk.rta.assets.material.asynctask.add (UD素材-创建异步任务接口)

UD素材-创建异步任务接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
material_task_top_dto MaterialTaskTopDTO 必须 入参,每个账户(adv)每天最多创建50个任务
  • params
  • MaterialTaskParamTopDTO
  • 必须
  • 素材上传任务参数
  • materials
  • MaterialUploadTopDTO []
  • 必须
  • 素材
  • 素材列表,最大100条
  • └ url
  • String
  • 必须
  • http://xxx
  • 素材url
  • └ name
  • String
  • 可选
  • 素材名称
  • 素材名称
  • └ type
  • Number
  • 必须
  • 1
  • 文件类型,1:图片,2:视频
  • └ advertiser_id
  • Number
  • 必须
  • 1
  • 广告主id
  • └ name
  • String
  • 必须
  • 任务名称
  • 任务名称
  • └ force
  • Number
  • 可选
  • 1
  • 强制生成新的任务,参数相同会复用之前的任务,1:是,0:否

响应参数

名称 类型 示例值 描述
result AsyncTaskTopDTO 返回结果
  • └ id
  • Number
  • 1
  • 任务id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaAssetsMaterialAsynctaskAddRequest req = new UnideskRtaAssetsMaterialAsynctaskAddRequest();
UnideskRtaAssetsMaterialAsynctaskAddRequest.MaterialTaskTopDTO obj1 = new UnideskRtaAssetsMaterialAsynctaskAddRequest.MaterialTaskTopDTO();
UnideskRtaAssetsMaterialAsynctaskAddRequest.MaterialTaskParamTopDTO obj2 = new UnideskRtaAssetsMaterialAsynctaskAddRequest.MaterialTaskParamTopDTO();
List<UnideskRtaAssetsMaterialAsynctaskAddRequest.MaterialUploadTopDTO> list4 = new ArrayList<UnideskRtaAssetsMaterialAsynctaskAddRequest.MaterialUploadTopDTO>();
UnideskRtaAssetsMaterialAsynctaskAddRequest.MaterialUploadTopDTO obj5 = new UnideskRtaAssetsMaterialAsynctaskAddRequest.MaterialUploadTopDTO();
list4.add(obj5);
obj5.setUrl("http://xxx");
obj5.setName("素材名称");
obj5.setType(1L);
obj2.setMaterials(list4);
obj1.setParams(obj2);
obj1.setAdvertiserId(1L);
obj1.setName("任务名称");
obj1.setForce(1L);
req.setMaterialTaskTopDto(obj1);
UnideskRtaAssetsMaterialAsynctaskAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<unidesk_rta_assets_material_asynctask_add_response>
    <result>
        <id>1</id>
    </result>
</unidesk_rta_assets_material_asynctask_add_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部