异步任务(Async Task)
V1.1
loading
V1.1
本节将为您介绍异步任务(Async Task)相关接口, 关于异步任务更详细的介绍可以参考【异步任务】章节。
所属权限(scope): Ads Insight
所属权限(scope):Ads Insight
所属权限(scope):Ads Insight
创建异步任务
全部接口
V1.1
loading
所属权限 | Ads Insight |
请求地址 | async_tasks/add |
请求方法 | post |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考。
参数名称 | 参数类型 |
---|---|
access_token | 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节 |
timestamp |
当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59 |
nonce | 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性 |
fields | get 接口增加 fields 字段,用于指定返回参数的字段列表,为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写,则根据默认值进行返回 |
请求参数
标有*的参数为必填项
名称 | 类型 | 描述 |
---|---|---|
account_id*
|
integer | 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id |
task_name*
|
string | 同一帐号名下不允许重复 字段长度最小 1 字节,长度最大 120 字节 |
task_type*
|
enum | 任务类型(部分任务待废弃)具体请参考,[枚举详情] 枚举列表:{ TASK_TYPE_AD_HOURLY_REPORT, TASK_TYPE_WECHAT_MOMENTS_ADGROUP_HOURLY_REPORT, TASK_TYPE_WECHAT_ADGROUP_HOURLY_REPORT, TASK_TYPE_WECHAT_ADGROUP_DAILY_REPORT, TASK_TYPE_WECHAT_AD_HOURLY_REPORT, TASK_TYPE_WECHAT_AD_DAILY_REPORT, TASK_TYPE_WECHAT_ADVERTISING_DATA, TASK_TYPE_WECHAT_POI_HOURLY_REPORT, TASK_TYPE_CREATE_ANDROID_CHANNEL_PACKAGE, TASK_TYPE_UPDATE_ANDROID_CHANNEL_PACKAGE, TASK_TYPE_CREATE_ANDROID_UNION_CHANNEL_PACKAGE, TASK_TYPE_UPDATE_ANDROID_UNION_CHANNEL_PACKAGE, TASK_TYPE_UNION_POSITION_REPORT, TASK_TYPE_UPDATE_ANDROID_UNION_CHANNEL_PACKAGE_BY_URL, TASK_TYPE_REVIEW_ELEMENT_PREREVIEW_RESULT, TASK_TYPE_MASSIVE_KEYWORD_RECOMMEND, TASK_TYPE_SEARCH_DOWNLOAD_ALL } |
task_spec
|
struct | 任务所需条件 |
report_task_spec
|
struct | 报表任务所需条件,当 task_type 为 TASK_TYPE_REPORT_AGENCY_ADVERTISER_HOURLY 时,report_task_spec 必填 |
level*
|
string | 报表类型级别 可选值:{ CAMPAIGN, ADGROUP } |
date*
|
string | 日期,日期格式:YYYY-MM-DD 字段长度为 10 字节 |
task_type_ad_hourly_report_spec
|
struct | 广告小时报表查询条件,当且仅当 task_type = TASK_TYPE_AD_HOURLY_REPORT 时,才可且必须使用 |
date*
|
string | 日期,格式 YYYY-MM-DD,只支持最近 30 天内的数据 字段长度为 10 字节 |
task_type_wechat_moments_adgroup_hourly_report_spec
|
struct | 微信朋友圈广告组小时报表查询条件,当且仅当 task_type = TASK_TYPE_WECHAT_MOMENTS_ADGROUP_HOURLY_REPORT 时,才可且必须使用 |
date*
|
string | 日期,格式 YYYY-MM-DD,只支持最近 30 天内的数据 字段长度为 10 字节 |
task_type_wechat_adgroup_hourly_report_spec
|
struct | 广告组小时报表查询条件,微信广告组小时报表查询条件,当且仅当 task_type = TASK_TYPE_WECHAT_ADGROUP_HOURLY_REPORT 时,才可且必须使用 |
date*
|
string | 日期,格式 YYYY-MM-DD,仅支持获取近一个月内的数据 字段长度为 10 字节 |
hour_range
|
struct | 查询的具体时段范围,begin_hour 小于等于 end_hour,最长时间跨度不超过 2 小时 |
begin_hour*
|
integer | 小时(0-23) 最小值 0,最大值 23 |
end_hour*
|
integer | 小时(0-23) 最小值 0,最大值 23 |
task_type_wechat_adgroup_daily_report_spec
|
struct | 广告组天报表查询条件,当且仅当 task_type = TASK_TYPE_WECHAT_ADGROUP_DAILY_REPORT 时,才可且必须使用 |
date*
|
string | 日期,格式 YYYY-MM-DD,只支持最近 1 年内的数据 字段长度为 10 字节 |
task_type_wechat_ad_hourly_report_spec
|
struct | 广告小时报表查询条件,微信广告小时报表查询条件,当且仅当 task_type = TASK_TYPE_WECHAT_AD_HOURLY_REPORT 时,才可且必须使用 |
date*
|
string | 日期,格式 YYYY-MM-DD,仅支持获取近一个月内的数据 字段长度为 10 字节 |
task_type_wechat_ad_daily_report_spec
|
struct | 广告组天报表查询条件,当且仅当 task_type = TASK_TYPE_WECHAT_AD_DAILY_REPORT 时,才可且必须使用 |
date*
|
string | 日期,格式 YYYY-MM-DD,只支持最近 1 年内的数据 字段长度为 10 字节 |
task_type_wechat_advertising_data_spec
|
struct | 获取微信数据任务查询条件,当且仅当 task_type = TASK_TYPE_WECHAT_ADVERTISING_DATA 时,才可且必须使用 |
last_modified_time_range*
|
struct | 广告组信息最后更新时间范围,一次最多允许获取 7 天的数据,最远可获取 2018.01.01 的数据 |
begin_time*
|
integer | 开始时间戳 最小值 0,最大值 9999999999 |
end_time*
|
integer | 结束时间戳 最小值 0,最大值 9999999999 |
fields*
|
string[] | 指定返回的字段列表 数组最小长度 1,最大长度 256 字段长度最小 1 字节,长度最大 64 字节 |
task_type_wechat_poi_hourly_report_spec
|
struct | 微信门店小时报表查询条件,当 task_type = TASK_TYPE_WECHAT_POI_HOURLY_REPORT 时,可填且必填 |
date*
|
string | 日期,格式 YYYY-MM-DD,只支持最近 30 天内的数据 字段长度为 10 字节 |
task_type_create_android_channel_package_spec
|
struct | 创建应用宝渠道包接口任务所需条件,当且仅当 task_type = TASK_TYPE_CREATE_ANDROID_CHANNEL_PACKAGE 时,才可且必须使用 |
myapp_auth_key*
|
string | 应用宝用户唯一标识 字段长度最小 1 字节,长度最大 64 字节 |
android_app_id*
|
integer | 应用宝 APP id |
android_channel_package_spec*
|
struct[] | 渠道包信息 数组最小长度 1,最大长度 100 |
package_name*
|
string | 渠道包名称 字段长度最小 1 字节,长度最大 1024 字节 |
download_url*
|
string | 渠道包下载地址 字段长度最小 1 字节,长度最大 10240 字节 |
task_type_update_android_channel_package_spec
|
struct | 更新应用宝渠道包接口任务所需条件,当且仅当 task_type = TASK_TYPE_UPDATE_ANDROID_CHANNEL_PACKAGE 时,才可且必须使用 |
myapp_auth_key*
|
string | 应用宝用户唯一标识 字段长度最小 1 字节,长度最大 64 字节 |
android_app_id*
|
integer | 应用宝 APP id |
android_channel_package_spec*
|
struct[] | 渠道包信息 数组最小长度 1,最大长度 100 |
channel_package_id*
|
string | 渠道包 id 字段长度最小 1 字节,长度最大 64 字节 |
download_url*
|
string | 渠道包下载地址 字段长度最小 1 字节,长度最大 10240 字节 |
task_type_create_android_union_channel_package_spec
|
struct | 创建广告渠道包接口任务所需条件,当且仅当 task_type = TASK_TYPE_CREATE_ANDROID_UNION_CHANNEL_PACKAGE 时,才可且必须使用 |
android_union_app_id*
|
integer | 广告包 APP id |
android_union_channel_package_spec*
|
struct[] | 渠道包信息 数组最小长度 1,最大长度 100 |
package_name*
|
string | 渠道包名称 字段长度最小 1 字节,长度最大 1024 字节 |
download_url*
|
string | 渠道包下载地址 字段长度最小 1 字节,长度最大 10240 字节 |
task_type_update_android_union_channel_package_spec
|
struct | 更新广告渠道包接口任务所需条件,当且仅当 task_type = TASK_TYPE_UPDATE_ANDROID_UNION_CHANNEL_PACKAGE 时,才可且必须使用 |
android_union_app_id*
|
integer | 广告包 APP id |
android_union_channel_package_spec*
|
struct[] | 渠道包信息 数组最小长度 1,最大长度 100 |
channel_package_id*
|
integer | 渠道包 id |
package_name
|
string | 渠道包名称 字段长度最小 1 字节,长度最大 1024 字节 |
download_url*
|
string | 渠道包下载地址 字段长度最小 1 字节,长度最大 10240 字节 |
task_type_union_position_report_spec
|
struct | 优量汇广告位报表查询条件,当且仅当 task_type = TASK_TYPE_UNION_POSITION_REPORT 时,才可且必须使用 |
date*
|
string | 日期,格式 YYYY-MM-DD 字段长度为 10 字节 |
task_type_review_element_prereview_result_spec
|
struct | 获取元素的预审结果条件,当且仅当 task_type = TASK_TYPE_REVIEW_ELEMENT_PREREVIEW_RESULT 时,才可且必须使用 |
adgroup_id
|
int64 | 广告组 id |
elements*
|
struct[] | 元素信息的列表 数组最小长度 1,最大长度 5 |
element_type*
|
enum | 元素类型,[枚举详情] 枚举列表:{ IMAGE, VIDEO, TXT, DEST_URL } |
element_content*
|
string | 元素内容:1)当元素类型为“图片”时,取值为:image_id 图片 id 2)当元素类型为“视频”时,取值为:video_id 视频 id 3)当元素类型为“文本”时,取值为:文本内容 4)当元素类型为”落地页“时,取值为:落地页的 URL 字段长度最小 0 字节,长度最大 256 字节 |
element_key
|
enum | 元素 key,[枚举详情] 枚举列表:{ IMG, TXT, CORPORATE_NAME, CORPORATE_IMG, BRAND_CORPORATE_NAME, BRAND_CORPORATE_IMG, BRAND_CORPORATE_DESC, BUTTON_TXT, BUTTON_URL, VIDEO_POPUP_BUTTON_TXT, VIDEO_POPUP_BUTTON_URL, DESC, URL, LEFT_BOTTOM_TXT, BOTTOM_TXT, GIF, VIDEO, LEFT_UPPER_TXT, SHARE_DESC, SHARE_IMG } |
supplement
|
struct[] | 补充信息,若此字段不传,或传空则视为无补充信息 数组最小长度 1,最大长度 50 |
field*
|
string | 过滤字段, 可选值:{ adcreative_template_id,mini_program_id,deep_link_url,site_set,campaign_id,is_dynamic_creative } |
operator*
|
enum | 操作符 当 field 取值 adcreative_template_id 时,枚举列表:{ EQUALS } 当 field 取值 mini_program_id 时,枚举列表:{ EQUALS } 当 field 取值 deep_link_url 时,枚举列表:{ EQUALS } 当 field 取值 site_set 时,枚举列表:{ EQUALS, IN } 当 field 取值 campaign_id 时,枚举列表:{ EQUALS } 当 field 取值 is_dynamic_creative 时,枚举列表:{ EQUALS } |
values*
|
string[] | 字段取值 当 field 取值 mini_program_id 时, 字段长度最小 1 字节,长度最大 400 字节 当 field 取值 deep_link_url 时, 字段长度最小 1 字节,长度最大 1000 字节 当 field 取值 site_set 时, 枚举列表:{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_KUAISHOU, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_MYAPP, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_YYB, SITE_SET_PENGYOU, SITE_SET_TUAN, SITE_SET_MEISHI, SITE_SET_PIAO, SITE_SET_MAIL, SITE_SET_PC_UNION, SITE_SET_YINGYONGBAO_PC, SITE_SET_PAIPAISEARCH, SITE_SET_QQSHOP, SITE_SET_PAIPAIDAOGOU, SITE_SET_QZONESEARCH, SITE_SET_WEBUNION_DELETED, SITE_SET_EXPRESSPORTAL, SITE_SET_WEIBO, SITE_SET_WANGGOU, SITE_SET_MOBILE_UNION_DELETED, SITE_SET_THIRDPARTY, SITE_SET_JD_WAICAI, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_QQSHOPPING, SITE_SET_PCAD } 当 field 取值 site_set 且 operator 取值 IN 时, 枚举列表:{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_KUAISHOU, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_MYAPP, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_YYB, SITE_SET_PENGYOU, SITE_SET_TUAN, SITE_SET_MEISHI, SITE_SET_PIAO, SITE_SET_MAIL, SITE_SET_PC_UNION, SITE_SET_YINGYONGBAO_PC, SITE_SET_PAIPAISEARCH, SITE_SET_QQSHOP, SITE_SET_PAIPAIDAOGOU, SITE_SET_QZONESEARCH, SITE_SET_WEBUNION_DELETED, SITE_SET_EXPRESSPORTAL, SITE_SET_WEIBO, SITE_SET_WANGGOU, SITE_SET_MOBILE_UNION_DELETED, SITE_SET_THIRDPARTY, SITE_SET_JD_WAICAI, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_QQSHOPPING, SITE_SET_PCAD } 当 field 取值 is_dynamic_creative 时, 枚举列表:{ DYNAMIC_CREATIVE, NOT_DYNAMIC_CREATIVE } |
task_type_massive_keyword_recommend_spec
|
struct | 海量拓词任务,当且仅当 task_type = TASK_TYPE_MASSIVE_KEYWORD_RECOMMEND 时, 才可且必须使用 |
massive_keyword_recommend_data_info*
|
struct | 拓词参数 |
seed_words*
|
string[] | 种子词列表 数组最小长度 1,最大长度 1000 字段长度最小 1 字节,长度最大 60 字节 |
is_filter_purchased_words*
|
enum | 是否过滤已购买词,[枚举详情] 枚举列表:{ FILTER_DISABLED, FILTER_ENABLED } |
site_sets*
|
enum[] | 流量类型,[枚举详情] 数组长度为 1 枚举列表:{ SITE_SET_WECHAT_SEARCH, SITE_SET_QBSEARCH, SITE_SET_SEARCH_MOBILE_UNION } |
exclude_words
|
string[] | 不包含词列表 数组最小长度 0,最大长度 100 字段长度最小 1 字节,长度最大 60 字节 |
contains_non_regional_words
|
enum | 是否包含非地域词,[枚举详情] 枚举列表:{ CONTAINS_REGION_ENABLED, CONTAINS_REGION_DISABLED } |
word_province
|
integer[] | 地域词省份编码,具体值参照附录中的 [地域信息] 数组最小长度 0,最大长度 35 |
word_city
|
integer[] | 地域词市编码,具体值参照附录中的 [地域信息] 数组最小长度 0,最大长度 500 |
task_type_search_download_all_spec
|
struct | 搜索整账户下载数据查询条件,当且仅当 task_type = TASK_TYPE_SEARCH_DOWNLOAD_ALL 时,才可且必须使用 |
campaign_ids
|
integer[] | 推广计划 id,数量不超过 100 个 数组最小长度 0,最大长度 100 |
adcleaner_update_adgroup_configured_status_spec
|
struct | 广告清理工具设置广告,当且仅当 task_type = TASK_TYPE_ADCLEANER_UPDATE_ADGROUP_CONFIGURED_STATUS 时,才可且必须使用 |
adclean_data*
|
struct | 更新数据 |
is_select_all
|
string | 是否选择全部数据 字段长度最小 0 字节,长度最大 256 字节 |
clean_data*
|
struct[] | 待清理广告数据 数组最小长度 0,最大长度 100 |
adgroup_id*
|
int64 | 广告组 id |
configured_status*
|
enum | 客户设置的状态,[枚举详情] 枚举列表:{ AD_STATUS_NORMAL, AD_STATUS_SUSPEND } |
account_id
|
integer | 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id |
query_info
|
string | 查询清理广告信息 字段长度最小 1 字节,长度最大 2024 字节 |
clean_mode*
|
enum | 清理模式,[枚举详情] 枚举列表:{ SYSTEM_CLEAN_LIGHT_MODE, SYSTEM_CLEAN_MODERATE_MODE, SYSTEM_CLEAN_SERIOUS_MODE, CUSTOM_CLEAN_MODE } |
adcleaner_delete_adgroup_spec
|
struct | 广告清理工具删除广告,当且仅当 task_type = TASK_TYPE_ADCLEANER_DELETE_ADGROUP 时,才可且必须使用 |
adclean_data*
|
struct | 删除数据 |
is_select_all
|
string | 是否选择全部数据 字段长度最小 0 字节,长度最大 256 字节 |
clean_data*
|
struct[] | 待清理广告数据 数组最小长度 0,最大长度 100 |
adgroup_id*
|
int64 | 广告组 id |
account_id
|
integer | 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id |
query_info
|
string | 查询清理广告信息 字段长度最小 1 字节,长度最大 2024 字节 |
clean_mode*
|
enum | 清理模式,[枚举详情] 枚举列表:{ SYSTEM_CLEAN_LIGHT_MODE, SYSTEM_CLEAN_MODERATE_MODE, SYSTEM_CLEAN_SERIOUS_MODE, CUSTOM_CLEAN_MODE } |
weixin_official_accounts_upgrade_enabled
|
boolean | 针对微信公众号账户是否使用升级的新调用方式,true:使用升级的新方式,false:不使用,不传则默认值 false ;详细情况请查看公告[Marketing API 微信公众平台账户服务升级] 可选值:{ true, false } |
使用说明
- 该接口灰度开放,如需使用请线下联系对接渠道运营同事申请。
- 只能由代理商账户创建的任务有:TASK_TYPE_WECHAT_ADGROUP_HOURLY_REPORT,TASK_TYPE_WECHAT_ADGROUP_DAILY_REPORT,TASK_TYPE_WECHAT_ADVERTISING_DATA。
请求示例
curl 'https://api.e.qq.com/v1.1/async_tasks/add?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'task_name=test task name' \
-d 'task_type=TASK_TYPE_AGENCY_AD_HOURLY_REPORT' \
-d 'task_spec={"task_type_agency_ad_hourly_report_spec":{"date":"2018-08-28"}}'
应答字段
名称 | 类型 | 描述 |
---|---|---|
task_id
|
integer | 任务 id |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"task_id": 1024
}
}
可视化调试工具
相关阅读
问题仍未解决?
请前往腾讯广告反馈中心在线提交问题,我们的人工客服将为你服务
-
异步任务限制每个账号(account_id)最多允许每5分钟创建1次
获取异步任务
全部接口
V1.1
loading
所属权限 | Ads Insight |
请求地址 | async_tasks/get |
请求方法 | get |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考。
参数名称 | 参数类型 |
---|---|
access_token | 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节 |
timestamp |
当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59 |
nonce | 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性 |
fields | get 接口增加 fields 字段,用于指定返回参数的字段列表,为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写,则根据默认值进行返回 |
请求参数
标有*的参数为必填项
名称 | 类型 | 描述 |
---|---|---|
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 |
使用说明
- 异步任务获取接口支持 7 日内任务记录的查询,单生成任务文件下载有效期为 24 小时。
请求示例
curl -G 'https://api.e.qq.com/v1.1/async_tasks/get?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[{"field":"task_id","operator":"EQUALS","values":["1024"]}]' \
-d 'page=1' \
-d 'page_size=10'
应答字段
名称 | 类型 | 描述 |
---|---|---|
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 | 总页数 |
应答示例
{
"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
}
}
}
可视化调试工具
相关阅读
问题仍未解决?
请前往腾讯广告反馈中心在线提交问题,我们的人工客服将为你服务
-
异步任务获取接口支持7日内任务记录的查询
-
所生成任务文件下载有效期为24小时
获取文件接口
全部接口
V1.1
loading
所属权限 | Ads Insight |
请求地址 | https://dl.e.qq.com/v1.1/async_task_files/get |
请求方法 | get |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考。
参数名称 | 参数类型 |
---|---|
access_token | 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节 |
timestamp |
当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59 |
nonce | 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性 |
fields | get 接口增加 fields 字段,用于指定返回参数的字段列表,为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写,则根据默认值进行返回 |
请求参数
标有*的参数为必填项
名称 | 类型 | 描述 |
---|---|---|
account_id*
|
integer | 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id |
task_id*
|
integer | 任务 id |
file_id*
|
integer | 文件 id |
使用说明
- 建议先下载整个文件,然后再解析。一边下载一边解析可能会因为处理时间较长而导致超时。
请求示例
curl -G 'https://dl.e.qq.com/v1.1/async_task_files/get?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'task_id=1024' \
-d 'file_id=<FILE_ID>'
应答字段
无应答示例
重定向到异步任务文件下载地址
相关阅读
问题仍未解决?
请前往腾讯广告反馈中心在线提交问题,我们的人工客服将为你服务
-
获取异步任务文件接口的域名为 dl.e.qq.com
-
获取任务文件对应的数据字段说明,可参考【异步任务】章节