所属权限 ads_management
请求地址 finder_ad_object_list/get
请求方法 GET

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考

参数名称 参数类型
access_token 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节
timestamp

当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。

MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳

MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59

nonce 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性

请求参数

标有*的参数为必填项

名称 类型 描述
account_id*
integer 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id
filtering
struct[] 过滤条件
数组最小长度 1,最大长度 255
field*
string 过滤字段
可选值:{ created_time, dynamic_creative_id, ad_export_id }
operator*
enum 操作符,[枚举详情]
当 field 取值 created_time 时,可选值:{ GREATER_EQUALS, LESS_EQUALS }
当 field 取值 dynamic_creative_id 时,可选值:{ EQUALS, IN }
当 field 取值 ad_export_id 时,可选值:{ EQUALS, IN }
values*
string[] 字段取值,values 数组元素的个数限制与 operator 的取值相关
当 field 取值 created_time 时,数组长度为 1
字段长度为 10 字节
当 field 取值 dynamic_creative_id 时,数组最小长度 1,最大长度 100
字段长度最小 1 字节,长度最大 1024 字节
当 field 取值 ad_export_id 时,数组最小长度 1,最大长度 100
字段长度最小 1 字节,长度最大 1024 字节
page
integer 搜索页码
最小值 1,最大值 99999
默认值:1
page_size
integer 一页显示的数据条数
最小值 1,最大值 100
默认值:10

请求示例


curl -v -G 'https://api.e.qq.com/v3.0/finder_ad_object_list/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[
    {
        "values": []
    }
]' \
-d 'page=1' \
-d 'page_size=10' 
					

应答字段

名称 类型 描述
list
struct[] 返回信息列表
finder_ad_object_id
integer 广告创意 id
finder_object
struct 视频号动态
finder_username
string 视频号账号 id 已废弃
description
string 视频号标题
medias
struct 视频号动态视频
thumb_url
string 视频号视频首帧图
cover_url
string 视频号视频封面图
url
string 视频号视频
description
string 视频号标题
video_play_len
integer 视频播放时长,单位:秒
flag
integer 动态标记类型
wechat_channels_account_id
string 视频号账号 id
wechat_channels_account_name
string 视频号名称
bullet_comment_switch_open
boolean 是否打开视频号弹幕开关,true:是,false:否
bullet_comment_supported
boolean 是否支持视频号弹幕,true:是,false:否
dynamic_creative_id
integer 广告创意 id
visibility_code
enum 不支持沉淀的状态码,[枚举详情]
jump_info
struct 主跳转组件,文本组件
component_id
integer 创意组件 id
value
struct 落地页内容结构定义,落地页组件内容结构定义,jump_info 结构单独显示,详见 [落地页内容结构详细定义]
page_type
enum 落地页类型,[枚举详情]
page_spec
struct 落地页内容
android_app_spec
struct android 默认落地页内容,通常情况下不需要额外数据;在视频号动态落地页内部按钮跳转时,需要额外传入 android_app_id、wechat_canvas_page_id 字段。
android_app_id
string 安卓应用直达 AppId
wechat_canvas_page_id
integer 落地页 id
ios_app_spec
struct android 默认落地页内容,通常情况下不需要额外数据;在视频号动态落地页内部按钮跳转时,需要额外传入 ios_app_id。
ios_app_id
string IOS 应用直达 AppId
xj_android_app_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_ios_app_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_web_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_quick_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
fengye_ecommmerce_spec
struct 枫叶落地页数据
page_id
int64 落地页 id
wechat_canvas_spec
struct 微信原生页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
override_canvas_head_option
enum 原生推广页顶部素材和广告创意素材之间的替换关系,(仅在朋友圈广告使用原生推广页情况下有效),[枚举详情]
wechat_channels_live_reserve_id
string 视频号直播预约 id
wechat_mini_program_spec
struct 小程序落地页,mini_program_id 和 mini_program_path 要同时填写
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
mini_program_paths
string[] 小程序落地页 path 列表
mpa_mini_program_wildcard_url
string mpa/dca 落地页通配符
wechat_canvas_mini_program_spec
struct 微信原生页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
override_canvas_head_option
enum 原生推广页顶部素材和广告创意素材之间的替换关系,(仅在朋友圈广告使用原生推广页情况下有效),[枚举详情]
wechat_channels_live_reserve_id
string 视频号直播预约 id
qq_app_mini_program_spec
struct 小程序落地页,mini_program_id 和 mini_program_path 要同时填写
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
qq_mini_game_spec
struct QQ 小游戏落地页信息
mini_game_tracking_parameter
string QQ 小游戏监控参数
simple_wechat_canvas_spec
struct 简版原生页相关信息,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
simple_canvas_webview_type
enum 简版原生页内嵌落地页类型,不大于 1024 个英文字符或数字,[枚举详情]
simple_canvas_webview_page_id
string 简版原生页内嵌落地页的 id,小于 128 个英文字符
simple_canvas_sub_type
enum 简版原生页子类型,灰度中,仅在简版原生页下生效,其他情况改字段内容会被忽略,[枚举详情]
simple_canvas_share_title
string ,分享标题
simple_canvas_share_desc
string ,分享描述
simple_canvas_webview_url
string 简易原生页嵌入 Webview url,和 simple_canvas_sub_type(灰度) 配合使用,关系如下:SIMPLE_CANVAS_SUB_TYPE_URL,SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP 时必填,SIMPLE_CANVAS_SUB_TYPE_WEB_STORE 时系统其他填充为 web store 地址,其他情况无效。
wechat_channels_live_reserve_id
string 视频号直播预约 id
mpa_simple_canvas_webview_wildcard_url
string mpa/dca 落地页通配符
wechat_focus_dialog_spec
struct 微信一键关注页
wechat_consult_spec
struct 微信客服落地页
page_url
string 落地页 url
wecom_consult_spec
struct 企业微信客服落地页
page_id
int64 落地页 id
group_type
enum 企微客服集类型,[枚举详情]
wechat_official_account_detail_spec
struct 微信公众号详情数据
app_id
string 公众号 appId
app_deep_link_spec
struct 应用直达数据
android_deep_link_app_id
string 安卓应用直达 AppId
android_deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
ios_deep_link_app_id
string IOS 应用直达 AppId
ios_deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
universal_link_url
string 通用链接页 URL
mpa_android_deep_link_wildcard_url
string deeplink 和 ulink 落地页通配符
mpa_ios_deep_link_wildcard_url
string deeplink 和 ulink 落地页通配符
mpa_universal_link_wildcard_url
string deeplink 和 ulink 落地页通配符
deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
app_market_spec
struct 厂商下载
android_direct_download_spec
struct Android 一键下载落地页
official_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
h5_profile_spec
struct 品牌形象页
page_id
int64 落地页 id
search_area_brand_spec
struct 超级品专头像页
search_brand_area_keyword
string 跳转超级品专搜索关键词
wechat_channels_profile_spec
struct 视频号落地页
username
string 视频号 username
h5_spec
struct 自定义落地页
page_url
string 落地页 url
mpa_h5_wildcard_url
string mpa/dca 落地页通配符
wechat_mini_game_spec
struct 小游戏落地页信息,视频号动态落地页内部按钮跳转时,需要额外传入 mini_game_id
mini_game_tracking_parameter
string 小游戏监控参数,需以英文字符?开头,如:?channel=xxxx,字段长度最小 1 个等宽字符,长度最大 250 个等宽字符(即字段最大长度为 250 个中文字或全角标点,500 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)
mini_game_id
string 小游戏 id
wechat_channels_feed_spec
struct 视频号动态落地页信息
feed_id
string 视频号动态 id
action_button
struct 行动按钮结构
button_text
string action_button button_text
jump_info
struct 落地页内容结构定义,落地页组件内容结构定义
page_type
enum 落地页类型,[枚举详情]
page_spec
struct 落地页内容
android_app_spec
struct android 默认落地页内容,通常情况下不需要额外数据;在视频号动态落地页内部按钮跳转时,需要额外传入 android_app_id、wechat_canvas_page_id 字段。
android_app_id
string 安卓应用直达 AppId
wechat_canvas_page_id
integer 落地页 id
ios_app_spec
struct android 默认落地页内容,通常情况下不需要额外数据;在视频号动态落地页内部按钮跳转时,需要额外传入 ios_app_id。
ios_app_id
string IOS 应用直达 AppId
xj_android_app_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_ios_app_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_web_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_quick_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
fengye_ecommmerce_spec
struct 枫叶落地页数据
page_id
int64 落地页 id
wechat_canvas_spec
struct 微信原生页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
override_canvas_head_option
enum 原生推广页顶部素材和广告创意素材之间的替换关系,(仅在朋友圈广告使用原生推广页情况下有效),[枚举详情]
wechat_channels_live_reserve_id
string 视频号直播预约 id
wechat_mini_program_spec
struct 小程序落地页,mini_program_id 和 mini_program_path 要同时填写
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
mini_program_paths
string[] 小程序落地页 path 列表
mpa_mini_program_wildcard_url
string mpa/dca 落地页通配符
wechat_canvas_mini_program_spec
struct 微信原生页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
override_canvas_head_option
enum 原生推广页顶部素材和广告创意素材之间的替换关系,(仅在朋友圈广告使用原生推广页情况下有效),[枚举详情]
wechat_channels_live_reserve_id
string 视频号直播预约 id
qq_app_mini_program_spec
struct 小程序落地页,mini_program_id 和 mini_program_path 要同时填写
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
simple_wechat_canvas_spec
struct 简版原生页相关信息,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
simple_canvas_webview_type
enum 简版原生页内嵌落地页类型,不大于 1024 个英文字符或数字,[枚举详情]
simple_canvas_webview_page_id
string 简版原生页内嵌落地页的 id,小于 128 个英文字符
simple_canvas_sub_type
enum 简版原生页子类型,灰度中,仅在简版原生页下生效,其他情况改字段内容会被忽略,[枚举详情]
simple_canvas_share_title
string ,分享标题
simple_canvas_share_desc
string ,分享描述
simple_canvas_webview_url
string 简易原生页嵌入 Webview url,和 simple_canvas_sub_type(灰度) 配合使用,关系如下:SIMPLE_CANVAS_SUB_TYPE_URL,SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP 时必填,SIMPLE_CANVAS_SUB_TYPE_WEB_STORE 时系统其他填充为 web store 地址,其他情况无效。
wechat_channels_live_reserve_id
string 视频号直播预约 id
mpa_simple_canvas_webview_wildcard_url
string mpa/dca 落地页通配符
wechat_focus_dialog_spec
struct 微信一键关注页
wechat_consult_spec
struct 微信客服落地页
page_url
string 落地页 url
wecom_consult_spec
struct 企业微信客服落地页
page_id
int64 落地页 id
group_type
enum 企微客服集类型,[枚举详情]
wechat_official_account_detail_spec
struct 微信公众号详情数据
app_id
string 公众号 appId
app_deep_link_spec
struct 应用直达数据
android_deep_link_app_id
string 安卓应用直达 AppId
android_deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
ios_deep_link_app_id
string IOS 应用直达 AppId
ios_deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
universal_link_url
string 通用链接页 URL
mpa_android_deep_link_wildcard_url
string deeplink 和 ulink 落地页通配符
mpa_ios_deep_link_wildcard_url
string deeplink 和 ulink 落地页通配符
mpa_universal_link_wildcard_url
string deeplink 和 ulink 落地页通配符
deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
app_market_spec
struct 厂商下载
android_direct_download_spec
struct Android 一键下载落地页
official_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
h5_profile_spec
struct 品牌形象页
page_id
int64 落地页 id
search_area_brand_spec
struct 超级品专头像页
search_brand_area_keyword
string 跳转超级品专搜索关键词
wechat_channels_profile_spec
struct 视频号落地页
username
string 视频号 username
h5_spec
struct 自定义落地页
page_url
string 落地页 url
mpa_h5_wildcard_url
string mpa/dca 落地页通配符
wechat_mini_game_spec
struct 小游戏落地页信息,视频号动态落地页内部按钮跳转时,需要额外传入 mini_game_id
mini_game_tracking_parameter
string 小游戏监控参数,需以英文字符?开头,如:?channel=xxxx,字段长度最小 1 个等宽字符,长度最大 250 个等宽字符(即字段最大长度为 250 个中文字或全角标点,500 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)
mini_game_id
string 小游戏 id
wechat_channels_reserve_spec
struct 视频号直播预约落地页信息
reserve_id
string 视频号直播预约 id
android_quick_app_spec
struct 安卓快应用落地页信息
jump_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
wechat_channels_reserve_spec
struct 视频号直播预约落地页信息
reserve_id
string 视频号直播预约 id
android_quick_app_spec
struct 安卓快应用落地页信息
jump_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
wechat_channels_shop_product_spec
struct 小店商品详情页落地页信息
product_id
integer 微信小店商品 id
shop_id
string 微信小店 id
backups
struct[] 兜底落地页内容列表,仅可在 page_type 为 PAGE_TYPE_APP_DEEP_LINK、PAGE_TYPE_APP_MARKET、PAGE_TYPE_WECHAT_MINI_PROGRAM、PAGE_TYPE_WECHAT_MINI_GAME 时使用
page_type
enum 落地页类型,[枚举详情]
page_spec
struct 落地页内容
android_app_spec
struct android 默认落地页内容,通常情况下不需要额外数据;在视频号动态落地页内部按钮跳转时,需要额外传入 android_app_id、wechat_canvas_page_id 字段。
android_app_id
string 安卓应用直达 AppId
wechat_canvas_page_id
integer 落地页 id
ios_app_spec
struct android 默认落地页内容,通常情况下不需要额外数据;在视频号动态落地页内部按钮跳转时,需要额外传入 ios_app_id。
ios_app_id
string IOS 应用直达 AppId
xj_android_app_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_ios_app_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_web_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_quick_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
fengye_ecommmerce_spec
struct 枫叶落地页数据
page_id
int64 落地页 id
wechat_canvas_spec
struct 微信原生页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
override_canvas_head_option
enum 原生推广页顶部素材和广告创意素材之间的替换关系,(仅在朋友圈广告使用原生推广页情况下有效),[枚举详情]
wechat_channels_live_reserve_id
string 视频号直播预约 id
wechat_mini_program_spec
struct 小程序落地页,mini_program_id 和 mini_program_path 要同时填写
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
mini_program_paths
string[] 小程序落地页 path 列表
mpa_mini_program_wildcard_url
string mpa/dca 落地页通配符
wechat_canvas_mini_program_spec
struct 微信原生页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
override_canvas_head_option
enum 原生推广页顶部素材和广告创意素材之间的替换关系,(仅在朋友圈广告使用原生推广页情况下有效),[枚举详情]
wechat_channels_live_reserve_id
string 视频号直播预约 id
qq_app_mini_program_spec
struct 小程序落地页,mini_program_id 和 mini_program_path 要同时填写
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
qq_mini_game_spec
struct QQ 小游戏落地页信息
mini_game_tracking_parameter
string QQ 小游戏监控参数
simple_wechat_canvas_spec
struct 简版原生页相关信息,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
simple_canvas_webview_type
enum 简版原生页内嵌落地页类型,不大于 1024 个英文字符或数字,[枚举详情]
simple_canvas_webview_page_id
string 简版原生页内嵌落地页的 id,小于 128 个英文字符
simple_canvas_sub_type
enum 简版原生页子类型,灰度中,仅在简版原生页下生效,其他情况改字段内容会被忽略,[枚举详情]
simple_canvas_share_title
string ,分享标题
simple_canvas_share_desc
string ,分享描述
simple_canvas_webview_url
string 简易原生页嵌入 Webview url,和 simple_canvas_sub_type(灰度) 配合使用,关系如下:SIMPLE_CANVAS_SUB_TYPE_URL,SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP 时必填,SIMPLE_CANVAS_SUB_TYPE_WEB_STORE 时系统其他填充为 web store 地址,其他情况无效。
wechat_channels_live_reserve_id
string 视频号直播预约 id
mpa_simple_canvas_webview_wildcard_url
string mpa/dca 落地页通配符
wechat_focus_dialog_spec
struct 微信一键关注页
wechat_consult_spec
struct 微信客服落地页
page_url
string 落地页 url
wecom_consult_spec
struct 企业微信客服落地页
page_id
int64 落地页 id
group_type
enum 企微客服集类型,[枚举详情]
wechat_official_account_detail_spec
struct 微信公众号详情数据
app_id
string 公众号 appId
app_deep_link_spec
struct 应用直达数据
android_deep_link_app_id
string 安卓应用直达 AppId
android_deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
ios_deep_link_app_id
string IOS 应用直达 AppId
ios_deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
universal_link_url
string 通用链接页 URL
mpa_android_deep_link_wildcard_url
string deeplink 和 ulink 落地页通配符
mpa_ios_deep_link_wildcard_url
string deeplink 和 ulink 落地页通配符
mpa_universal_link_wildcard_url
string deeplink 和 ulink 落地页通配符
deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
app_market_spec
struct 厂商下载
android_direct_download_spec
struct Android 一键下载落地页
official_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
h5_profile_spec
struct 品牌形象页
page_id
int64 落地页 id
search_area_brand_spec
struct 超级品专头像页
search_brand_area_keyword
string 跳转超级品专搜索关键词
wechat_channels_profile_spec
struct 视频号落地页
username
string 视频号 username
h5_spec
struct 自定义落地页
page_url
string 落地页 url
mpa_h5_wildcard_url
string mpa/dca 落地页通配符
wechat_mini_game_spec
struct 小游戏落地页信息,视频号动态落地页内部按钮跳转时,需要额外传入 mini_game_id
mini_game_tracking_parameter
string 小游戏监控参数,需以英文字符?开头,如:?channel=xxxx,字段长度最小 1 个等宽字符,长度最大 250 个等宽字符(即字段最大长度为 250 个中文字或全角标点,500 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)
mini_game_id
string 小游戏 id
wechat_channels_feed_spec
struct 视频号动态落地页信息
feed_id
string 视频号动态 id
action_button
struct 行动按钮结构
button_text
string action_button button_text
jump_info
struct 落地页内容结构定义,落地页组件内容结构定义
page_type
enum 落地页类型,[枚举详情]
page_spec
struct 落地页内容
android_app_spec
struct android 默认落地页内容,通常情况下不需要额外数据;在视频号动态落地页内部按钮跳转时,需要额外传入 android_app_id、wechat_canvas_page_id 字段。
android_app_id
string 安卓应用直达 AppId
wechat_canvas_page_id
integer 落地页 id
ios_app_spec
struct android 默认落地页内容,通常情况下不需要额外数据;在视频号动态落地页内部按钮跳转时,需要额外传入 ios_app_id。
ios_app_id
string IOS 应用直达 AppId
xj_android_app_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_ios_app_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_web_h5_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
xj_quick_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
fengye_ecommmerce_spec
struct 枫叶落地页数据
page_id
int64 落地页 id
wechat_canvas_spec
struct 微信原生页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
override_canvas_head_option
enum 原生推广页顶部素材和广告创意素材之间的替换关系,(仅在朋友圈广告使用原生推广页情况下有效),[枚举详情]
wechat_channels_live_reserve_id
string 视频号直播预约 id
wechat_mini_program_spec
struct 小程序落地页,mini_program_id 和 mini_program_path 要同时填写
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
mini_program_paths
string[] 小程序落地页 path 列表
mpa_mini_program_wildcard_url
string mpa/dca 落地页通配符
wechat_canvas_mini_program_spec
struct 微信原生页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
override_canvas_head_option
enum 原生推广页顶部素材和广告创意素材之间的替换关系,(仅在朋友圈广告使用原生推广页情况下有效),[枚举详情]
wechat_channels_live_reserve_id
string 视频号直播预约 id
qq_app_mini_program_spec
struct 小程序落地页,mini_program_id 和 mini_program_path 要同时填写
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
simple_wechat_canvas_spec
struct 简版原生页相关信息,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
simple_canvas_webview_type
enum 简版原生页内嵌落地页类型,不大于 1024 个英文字符或数字,[枚举详情]
simple_canvas_webview_page_id
string 简版原生页内嵌落地页的 id,小于 128 个英文字符
simple_canvas_sub_type
enum 简版原生页子类型,灰度中,仅在简版原生页下生效,其他情况改字段内容会被忽略,[枚举详情]
simple_canvas_share_title
string ,分享标题
simple_canvas_share_desc
string ,分享描述
simple_canvas_webview_url
string 简易原生页嵌入 Webview url,和 simple_canvas_sub_type(灰度) 配合使用,关系如下:SIMPLE_CANVAS_SUB_TYPE_URL,SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP 时必填,SIMPLE_CANVAS_SUB_TYPE_WEB_STORE 时系统其他填充为 web store 地址,其他情况无效。
wechat_channels_live_reserve_id
string 视频号直播预约 id
mpa_simple_canvas_webview_wildcard_url
string mpa/dca 落地页通配符
wechat_focus_dialog_spec
struct 微信一键关注页
wechat_consult_spec
struct 微信客服落地页
page_url
string 落地页 url
wecom_consult_spec
struct 企业微信客服落地页
page_id
int64 落地页 id
group_type
enum 企微客服集类型,[枚举详情]
wechat_official_account_detail_spec
struct 微信公众号详情数据
app_id
string 公众号 appId
app_deep_link_spec
struct 应用直达数据
android_deep_link_app_id
string 安卓应用直达 AppId
android_deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
ios_deep_link_app_id
string IOS 应用直达 AppId
ios_deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
universal_link_url
string 通用链接页 URL
mpa_android_deep_link_wildcard_url
string deeplink 和 ulink 落地页通配符
mpa_ios_deep_link_wildcard_url
string deeplink 和 ulink 落地页通配符
mpa_universal_link_wildcard_url
string deeplink 和 ulink 落地页通配符
deep_link_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
app_market_spec
struct 厂商下载
android_direct_download_spec
struct Android 一键下载落地页
official_spec
struct 蹊径落地页数据,当营销载体类型为视频号直播预约时,需要额外传入 wechat_channels_live_reserve_id
page_id
int64 落地页 id
wechat_channels_live_reserve_id
string 视频号直播预约 id
h5_profile_spec
struct 品牌形象页
page_id
int64 落地页 id
search_area_brand_spec
struct 超级品专头像页
search_brand_area_keyword
string 跳转超级品专搜索关键词
wechat_channels_profile_spec
struct 视频号落地页
username
string 视频号 username
h5_spec
struct 自定义落地页
page_url
string 落地页 url
mpa_h5_wildcard_url
string mpa/dca 落地页通配符
wechat_mini_game_spec
struct 小游戏落地页信息,视频号动态落地页内部按钮跳转时,需要额外传入 mini_game_id
mini_game_tracking_parameter
string 小游戏监控参数,需以英文字符?开头,如:?channel=xxxx,字段长度最小 1 个等宽字符,长度最大 250 个等宽字符(即字段最大长度为 250 个中文字或全角标点,500 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)
mini_game_id
string 小游戏 id
wechat_channels_reserve_spec
struct 视频号直播预约落地页信息
reserve_id
string 视频号直播预约 id
android_quick_app_spec
struct 安卓快应用落地页信息
jump_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
wechat_channels_reserve_spec
struct 视频号直播预约落地页信息
reserve_id
string 视频号直播预约 id
android_quick_app_spec
struct 安卓快应用落地页信息
jump_url
string 应用直达 schema,大于 0 个并小于 2048 个字符
wechat_channels_shop_product_spec
struct 小店商品详情页落地页信息
product_id
integer 微信小店商品 id
shop_id
string 微信小店 id
ad_export_id
string 视频号动态 id
page_info
struct 分页配置信息
page
integer 搜索页码
默认值:1
page_size
integer 一页显示的数据条数
默认值:10
total_number
integer 总条数
total_page
integer 总页数

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "finder_object": {
                    "medias": []
                },
                "jump_info": {
                    "value": {
                        "page_spec": {
                            "android_app_spec": [],
                            "ios_app_spec": [],
                            "xj_android_app_h5_spec": [],
                            "xj_ios_app_h5_spec": [],
                            "xj_web_h5_spec": [],
                            "xj_quick_spec": [],
                            "fengye_ecommmerce_spec": [],
                            "wechat_canvas_spec": [],
                            "wechat_mini_program_spec": {
                                "mini_program_paths": []
                            },
                            "wechat_canvas_mini_program_spec": [],
                            "qq_app_mini_program_spec": [],
                            "qq_mini_game_spec": [],
                            "simple_wechat_canvas_spec": [],
                            "wechat_consult_spec": [],
                            "wecom_consult_spec": [],
                            "wechat_official_account_detail_spec": [],
                            "app_deep_link_spec": [],
                            "official_spec": [],
                            "h5_profile_spec": [],
                            "search_area_brand_spec": [],
                            "wechat_channels_profile_spec": [],
                            "h5_spec": [],
                            "wechat_mini_game_spec": [],
                            "wechat_channels_feed_spec": {
                                "action_button": {
                                    "jump_info": {
                                        "page_spec": {
                                            "android_app_spec": [],
                                            "ios_app_spec": [],
                                            "xj_android_app_h5_spec": [],
                                            "xj_ios_app_h5_spec": [],
                                            "xj_web_h5_spec": [],
                                            "xj_quick_spec": [],
                                            "fengye_ecommmerce_spec": [],
                                            "wechat_canvas_spec": [],
                                            "wechat_mini_program_spec": {
                                                "mini_program_paths": []
                                            },
                                            "wechat_canvas_mini_program_spec": [],
                                            "qq_app_mini_program_spec": [],
                                            "simple_wechat_canvas_spec": [],
                                            "wechat_consult_spec": [],
                                            "wecom_consult_spec": [],
                                            "wechat_official_account_detail_spec": [],
                                            "app_deep_link_spec": [],
                                            "official_spec": [],
                                            "h5_profile_spec": [],
                                            "search_area_brand_spec": [],
                                            "wechat_channels_profile_spec": [],
                                            "h5_spec": [],
                                            "wechat_mini_game_spec": [],
                                            "wechat_channels_reserve_spec": [],
                                            "android_quick_app_spec": []
                                        }
                                    }
                                }
                            },
                            "wechat_channels_reserve_spec": [],
                            "android_quick_app_spec": [],
                            "wechat_channels_shop_product_spec": []
                        },
                        "backups": [
                            {
                                "page_spec": {
                                    "android_app_spec": [],
                                    "ios_app_spec": [],
                                    "xj_android_app_h5_spec": [],
                                    "xj_ios_app_h5_spec": [],
                                    "xj_web_h5_spec": [],
                                    "xj_quick_spec": [],
                                    "fengye_ecommmerce_spec": [],
                                    "wechat_canvas_spec": [],
                                    "wechat_mini_program_spec": {
                                        "mini_program_paths": []
                                    },
                                    "wechat_canvas_mini_program_spec": [],
                                    "qq_app_mini_program_spec": [],
                                    "qq_mini_game_spec": [],
                                    "simple_wechat_canvas_spec": [],
                                    "wechat_consult_spec": [],
                                    "wecom_consult_spec": [],
                                    "wechat_official_account_detail_spec": [],
                                    "app_deep_link_spec": [],
                                    "official_spec": [],
                                    "h5_profile_spec": [],
                                    "search_area_brand_spec": [],
                                    "wechat_channels_profile_spec": [],
                                    "h5_spec": [],
                                    "wechat_mini_game_spec": [],
                                    "wechat_channels_feed_spec": {
                                        "action_button": {
                                            "jump_info": {
                                                "page_spec": {
                                                    "android_app_spec": [],
                                                    "ios_app_spec": [],
                                                    "xj_android_app_h5_spec": [],
                                                    "xj_ios_app_h5_spec": [],
                                                    "xj_web_h5_spec": [],
                                                    "xj_quick_spec": [],
                                                    "fengye_ecommmerce_spec": [],
                                                    "wechat_canvas_spec": [],
                                                    "wechat_mini_program_spec": {
                                                        "mini_program_paths": []
                                                    },
                                                    "wechat_canvas_mini_program_spec": [],
                                                    "qq_app_mini_program_spec": [],
                                                    "simple_wechat_canvas_spec": [],
                                                    "wechat_consult_spec": [],
                                                    "wecom_consult_spec": [],
                                                    "wechat_official_account_detail_spec": [],
                                                    "app_deep_link_spec": [],
                                                    "official_spec": [],
                                                    "h5_profile_spec": [],
                                                    "search_area_brand_spec": [],
                                                    "wechat_channels_profile_spec": [],
                                                    "h5_spec": [],
                                                    "wechat_mini_game_spec": [],
                                                    "wechat_channels_reserve_spec": [],
                                                    "android_quick_app_spec": []
                                                }
                                            }
                                        }
                                    },
                                    "wechat_channels_reserve_spec": [],
                                    "android_quick_app_spec": [],
                                    "wechat_channels_shop_product_spec": []
                                }
                            }
                        ]
                    }
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

可视化调试工具