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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
async_task_top_query_dto AsyncTaskTopQueryDTO 必须 查询参数
  • └ page_no
  • Number
  • 可选
  • 1
  • 第几页
  • └ name
  • String
  • 可选
  • 任务名称
  • 任务名称(废弃)
  • └ ids
  • Number []
  • 可选
  • 1
  • 任务ids
  • └ page_size
  • Number
  • 可选
  • 10
  • 每页多少条
  • └ advertiser_id
  • Number
  • 必须
  • 1
  • 广告主id
  • └ version
  • Number
  • 可选
  • 9999
  • 平台版本,9999:升级版API(仅巨量2.0API需传入)3:腾讯3.0需要传入

响应参数

名称 类型 示例值 描述
result AsyncTaskTopDTO [] 任务信息
  • └ id
  • Number
  • 1
  • 任务id
  • └ data_size
  • Number
  • 1024
  • 结果数据大小byte(废弃)
  • └ gmt_create
  • Date
  • 1671810808398
  • 任务创建时间
  • └ error_msg
  • String
  • 任务失败原因
  • 任务失败原因(废弃)
  • └ name
  • String
  • 异步任务名称
  • 任务名称
  • └ status
  • Number
  • 3
  • 任务状态,1:待运行,2:运行中,3:运行成功,4:运行失败
total Number 1 总条数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaReportAsynctaskGetRequest req = new UnideskRtaReportAsynctaskGetRequest();
UnideskRtaReportAsynctaskGetRequest.AsyncTaskTopQueryDTO obj1 = new UnideskRtaReportAsynctaskGetRequest.AsyncTaskTopQueryDTO();
obj1.setPageNo(1L);
obj1.setName("任务名称");
obj1.setIds(new Long[] { 1 };
);
obj1.setPageSize(10L);
obj1.setAdvertiserId(1L);
obj1.setVersion(9999L);
req.setAsyncTaskTopQueryDto(obj1);
UnideskRtaReportAsynctaskGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<unidesk_rta_report_asynctask_get_response>
    <result>
        <async_task_top_d_t_o>
            <id>1</id>
            <data_size>1024</data_size>
            <gmt_create>1671810808398</gmt_create>
            <error_msg>任务失败原因</error_msg>
            <name>异步任务名称</name>
            <status>3</status>
        </async_task_top_d_t_o>
    </result>
    <total>1</total>
</unidesk_rta_report_asynctask_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

返回
顶部