获取异步任务

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id
filtering	struct[]	过滤条件，若此字段不传，或传空则视为无限制条件，详见 [过滤条件] 数组最小长度 1，最大长度 2
field*	string	过滤字段可选值：{ task_id, task_name }
operator*	enum	操作符当 field 取值 task_id 时，枚举列表：{ EQUALS, IN } 当 field 取值 task_name 时，枚举列表：{ EQUALS, CONTAINS }
values*	string[]	字段取值当 field 取值 task_name 时，字段长度最小 1 字节，长度最大 120 字节
page	integer	搜索页码，默认值：1 最小值 1，最大值 99999
page_size	integer	一页显示的数据条数，默认值：10 最小值 1，最大值 100

应答字段

名称	类型	描述
list	struct[]	返回信息列表
task_id	integer	任务 id
task_name	string	同一帐号名下不允许重复
task_type	enum	任务类型（部分任务待废弃）具体请参考，[枚举详情]
status	enum	任务状态，[枚举详情]
created_time	integer	任务创建时间戳（Unix 时间戳，单位为秒），大于等于 0
result	struct	任务结果
code	integer	返回码，正常返回 0，异常返回大于 0
message	string	返回消息
data	struct	任务结果
file_info_list	struct[]	文件返回结果列表
file_id	integer	文件 id
md5	string	文件 md5
channel_package_info_list	struct[]	应用宝渠道包任务处理信息,仅支持当 task_type=TASK_TYPE_CREATE_ANDROID_CHANNEL_PACKAGE，TASK_TYPE_UPDATE_ANDROID_CHANNEL_PACKAGE 数据返回
android_app_id	integer	应用宝 APP id，大于等于 0
package_name	string	渠道包名称
status	enum	渠道包任务处理状态，[枚举详情]
error_code	enum	渠道包任务错误码，[枚举详情]
created_time	integer	任务创建时间戳（Unix 时间戳，单位为秒），大于等于 0
last_modified_time	integer	最后修改时间（时间戳）
channel_package_id	string	渠道包 id
union_channel_package_info_list	struct[]	广告渠道包任务处理信息,仅支持当 task_type=TASK_TYPE_CREATE_ANDROID_UNION_CHANNEL_PACKAGE，TASK_TYPE_UPDATE_ANDROID_UNION_CHANNEL_PACKAGE 数据返回
android_union_app_id	integer	广告包 APP id，大于等于 0
package_name	string	渠道包名称
status	enum	渠道包任务处理状态，[枚举详情]
created_time	integer	任务创建时间戳（Unix 时间戳，单位为秒），大于等于 0
last_modified_time	integer	最后修改时间（时间戳）
review_element_prereview_result_list	struct[]	预审结果集合信息,仅支持当 task_type=TASK_TYPE_REVIEW_ELEMENT_PREREVIEW_RESULT 时，数据返回
element_type	enum	元素类型，[枚举详情]
element_content	string	元素内容：1）当元素类型为“图片”时，取值为：image_id 图片 id 2）当元素类型为“视频”时，取值为：video_id 视频 id 3）当元素类型为“文本”时，取值为：文本内容 4）当元素类型为”落地页“时，取值为：落地页的 URL
risk_level	enum	元素风险级别，[枚举详情]
pre_review_details	struct[]	元素预审结果明细集合
site_set	enum	预审投放版位集合，[枚举详情]
pre_review_result	enum	投放版位的预审结果，[枚举详情]
reject_reason_detail	struct[]	拒绝原因明细集合
reject_reason_id	string	拒绝原因 id
reject_reason_content	string	拒绝原因内容
case_doc	string	案例 url
case_content	string	案例内容富文本
reject_info_locations	struct[]	元素拒绝原因详情
x	integer	x 轴位置
y	integer	y 轴位置
width	integer	宽度
height	integer	高度
time_second	float	视频时间点
location_img_url	string	标注结果图 url
img_url	string	帧图片 url
related_img_url	string	种子图 url
page_info	struct	分页配置信息
page	integer	搜索页码
page_size	integer	一页显示的数据条数
total_number	integer	总条数
total_page	integer	总页数

curl --location --request GET '/v1.3/async_tasks/get' \ --header 'access_token;' \ --header 'timestamp;' \ --header 'nonce;' \ --header 'fields;' \ --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", "task_type": "TASK_TYPE_AGENCY_AD_HOURLY_REPORT", "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 } } }

请求参数

Header 参数

access_token

string

必需

以Query Parameter方式在请求路径中传递。授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节。

默认值:

<ACCESS_TOKEN>

timestamp

string

必需

以Query Parameter方式在请求路径中传递。当前的时间戳，单位为秒，允许客户端请求最大时间误差为300秒。
MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1494840119时，表示 2018-05-15 17:21:59

默认值:

nonce

string

必需

以Query Parameter方式在请求路径中传递。随机字串标识，不超过32个字符，由调用方自行生成，需保证全局唯一性。

默认值:

<NONCE>

fields

string

必需

指定返回的字段列表，为选填字段，如不填写，则根据默认值进行返回

Body 参数application/x-www-form-urlencoded

account_id

integer

必需

推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id

示例值:

<ACCOUNT_ID>

filtering

string

必需

过滤条件，若此字段不传，或传空则视为无限制条件，详见 [过滤条件]
数组最小长度 1，最大长度 2

示例值:

[{"field":"task_id","operator":"EQUALS","values":["1024"]}]

page

integer

可选

搜索页码，默认值：1
最小值 1，最大值 99999

示例值:

page_size

integer

可选

一页显示的数据条数，默认值：10
最小值 1，最大值 100

示例值:

application/json

Body

code

integer

必需

message

string

必需

message_cn

string

必需

data

object

必需

list

array [object {6}]

返回信息列表

必需

page_info

object

分页配置信息

必需

请求参数#

应答字段#

请求参数

返回响应

请求参数

应答字段