名称 | 类型 | 描述 |
---|---|---|
account_id* | integer | 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id |
filtering | struct[] | 过滤条件,若此字段不传,或传空则视为无限制条件,详见 [过滤条件] 数组最小长度 1,最大长度 10 |
field* | string | 过滤字段 可选值:{ task_id, task_type, task_name, created_time, result_status, status, cron_status } |
operator* | enum | 操作符 当 field 取值 task_id 时,枚举列表:{ EQUALS, IN } 当 field 取值 task_type 时,枚举列表:{ EQUALS, IN } 当 field 取值 task_name 时,枚举列表:{ EQUALS, CONTAINS } 当 field 取值 created_time 时,枚举列表:{ EQUALS, LESS_EQUALS, LESS, GREATER_EQUALS, GREATER } 当 field 取值 result_status 时,枚举列表:{ EQUALS, IN } 当 field 取值 status 时,枚举列表:{ EQUALS, IN } 当 field 取值 cron_status 时,枚举列表:{ EQUALS, IN } |
values* | string[] | 字段取值 当 field 取值 task_type 时, 枚举列表:{ } 当 field 取值 task_type 且 operator 取值 IN 时, 枚举列表:{ } 当 field 取值 task_name 时, 字段长度最小 1 字节,长度最大 120 字节 当 field 取值 created_time 时, 字段长度为 10 字节 当 field 取值 result_status 时, 枚举列表:{ TASK_RESULT_STATUS_UNKNOWN, TASK_RESULT_STATUS_PENDING, TASK_RESULT_STATUS_PROCESSING, TASK_RESULT_STATUS_SUCCESS, TASK_RESULT_STATUS_FAIL, TASK_RESULT_STATUS_PARTIAL_FAIL, TASK_RESULT_STATUS_SYSTEM_ERROR, TASK_RESULT_STATUS_DELETED } 当 field 取值 result_status 且 operator 取值 IN 时, 枚举列表:{ TASK_RESULT_STATUS_UNKNOWN, TASK_RESULT_STATUS_PENDING, TASK_RESULT_STATUS_PROCESSING, TASK_RESULT_STATUS_SUCCESS, TASK_RESULT_STATUS_FAIL, TASK_RESULT_STATUS_PARTIAL_FAIL, TASK_RESULT_STATUS_SYSTEM_ERROR, TASK_RESULT_STATUS_DELETED } 当 field 取值 status 时, 枚举列表:{ TASK_STATUS_PENDING, TASK_STATUS_PROCESSING, TASK_STATUS_EXPIRED, TASK_STATUS_COMPLETED, TASK_STATUS_FAIL, TASK_STATUS_DELETED, TASK_STATUS_DRAFT } 当 field 取值 status 且 operator 取值 IN 时, 枚举列表:{ TASK_STATUS_PENDING, TASK_STATUS_PROCESSING, TASK_STATUS_EXPIRED, TASK_STATUS_COMPLETED, TASK_STATUS_FAIL, TASK_STATUS_DELETED, TASK_STATUS_DRAFT } 当 field 取值 cron_status 时, 枚举列表:{ CRON_STATUS_ON, CRON_STATUS_OFF, CRON_STATUS_DELETE } 当 field 取值 cron_status 且 operator 取值 IN 时, 枚举列表:{ CRON_STATUS_ON, CRON_STATUS_OFF, CRON_STATUS_DELETE } |
page | integer | 搜索页码,默认值:1 最小值 1,最大值 99999 |
page_size | integer | 一页显示的数据条数,默认值:10 最小值 1,最大值 100 |
使用说明 1.异步任务获取接口支持 7 日内任务记录的查询,单生成任务文件下载有效期为 24 小时。
curl --location --request POST '/v1.3/async_reports/get' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'filtering=[{"field":"task_id","operator":"EQUALS","values":["1024"]}]' \
--data-urlencode 'page=1' \
--data-urlencode 'page_size=10'
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"task_id": 1024,
"task_name": "test_task_name",
"status": "TASK_STATUS_COMPLETED",
"created_time": 1403243242,
"result": {
"code": 0,
"message": "",
"data": {
"file_info_list": [
{
"file_id": 5,
"md5": "79054025255fb1a26e4bc422aef54eb4"
}
]
}
}
}
],
"page_info": {
"page": 1,
"page_size": 10,
"total_number": 1,
"total_page": 1
}
}
}