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

taobao.unidesk.rta.report.asynctask.result.get (UD报表-异步任务结果查询接口)

UD报表-异步任务结果查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
async_task_top_query_dto AsyncTaskTopQueryDTO 必须 查询参数
  • └ id
  • Number
  • 必须
  • 1
  • 任务id
  • └ advertiser_id
  • Number
  • 必须
  • 1
  • 广告主id
  • └ version
  • Number
  • 可选
  • 9999
  • 平台版本,9999:升级版API(仅巨量2.0API需传入)3:腾讯3.0需要传入

响应参数

名称 类型 示例值 描述
result AsyncTaskTopDTO 任务信息
  • └ result
  • String
  • http://top-async-task.oss-cn-zhangjiakou.aliyuncs.com/test-csv.csv?Expires=1670417132&OSSAccessKeyId=TMP.3KfftyCXfnhBUSGgoHkz8w3hfGXCd69wWqioPbhCWS9voiC1nmdTsecB2CPfKMRFQkE8BWjhCrFJ4VBTeQ3cVJf5pRqNLn&Signature=4x8hvt3wVWrzqExaFLj07VCtJgU%3D
  • 报表数据文件地址,excel格式,有效期5分钟,文件过期可重新调此接口获取
  • └ id
  • Number
  • 1
  • 任务id
  • └ data_size
  • Number
  • 1024
  • 报表数据大小byte(废弃)
  • └ gmt_create
  • Date
  • 1671810861295
  • 任务创建时间
  • └ name
  • String
  • 任务名称
  • 任务名称
  • └ status
  • Number
  • 3
  • 任务状态,1:待运行,2:运行中,3:运行成功,4:运行失败

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaReportAsynctaskResultGetRequest req = new UnideskRtaReportAsynctaskResultGetRequest();
UnideskRtaReportAsynctaskResultGetRequest.AsyncTaskTopQueryDTO obj1 = new UnideskRtaReportAsynctaskResultGetRequest.AsyncTaskTopQueryDTO();
obj1.setId(1L);
obj1.setAdvertiserId(1L);
obj1.setVersion(9999L);
req.setAsyncTaskTopQueryDto(obj1);
UnideskRtaReportAsynctaskResultGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<unidesk_rta_report_asynctask_result_get_response>
    <result>
        <result>http://top-async-task.oss-cn-zhangjiakou.aliyuncs.com/test-csv.csv?Expires=1670417132&amp;OSSAccessKeyId=TMP.3KfftyCXfnhBUSGgoHkz8w3hfGXCd69wWqioPbhCWS9voiC1nmdTsecB2CPfKMRFQkE8BWjhCrFJ4VBTeQ3cVJf5pRqNLn&amp;Signature=4x8hvt3wVWrzqExaFLj07VCtJgU%3D</result>
        <id>1</id>
        <data_size>1024</data_size>
        <gmt_create>1671810861295</gmt_create>
        <name>任务名称</name>
        <status>3</status>
    </result>
</unidesk_rta_report_asynctask_result_get_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

返回
顶部