接口文档SDK业务专题开发者工具

获取微信落地页列表
全部接口
V1.1
loading

所属权限 Ads Management
请求地址 wechat_pages/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[] 过滤条件,若此字段不传,或传空则视为无限制条件,adcreative_template_id 必须和 promoted_object_type 同时使用,详见 [过滤条件]
数组最小长度 1,最大长度 6
field*
string 过滤字段
可选值:{ page_id, page_name, adcreative_template_id, promoted_object_type, page_type, promoted_object_id }
operator*
enum 操作符
当 field 取值 page_id 时,枚举列表:{ EQUALS, IN }
当 field 取值 page_name 时,枚举列表:{ EQUALS, CONTAINS }
当 field 取值 adcreative_template_id 时,枚举列表:{ EQUALS }
当 field 取值 promoted_object_type 时,枚举列表:{ EQUALS }
当 field 取值 page_type 时,枚举列表:{ EQUALS }
当 field 取值 promoted_object_id 时,枚举列表:{ EQUALS }
values*
string[] 字段取值

当 field 取值 page_name 时,
字段长度最小 1 字节,长度最大 120 字节

当 field 取值 promoted_object_type 时,
枚举列表:{ PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT }
page
integer 搜索页码,默认值:1
最小值 1,最大值 99999
page_size
integer 一页显示的数据条数,默认值:10
最小值 1,最大值 100

使用说明

  1. 过滤字段 adcreative_template_id 必须和 promoted_object_type 同时使用。

请求示例


curl -G 'https://api.e.qq.com/v1.1/wechat_pages/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[{"field":"page_id","operator":"EQUALS","values":["<PAGE_ID>"]},{"field":"page_name","operator":"EQUALS","values":["test name"]},{"field":"adcreative_template_id","operator":"EQUALS","values":["263"]},{"field":"promoted_object_type","operator":"EQUALS","values":["PROMOTED_OBJECT_TYPE_LINK_WECHAT"]}]' \
-d 'page=1' \
-d 'page_size=10' 
					

应答字段

名称 类型 描述
list
struct[] 返回信息列表
page_id
integer 落地页 id
page_name
string 落地页名称
created_time
integer 创建时间戳(Unix 时间戳,单位为秒)
last_modified_time
integer 最后修改时间戳(Unix 时间戳,单位为秒)
page_template_id
integer 落地页模板 id
page_elements_spec_list
struct[] 组件素材内容,组件的同步顺序与原生页的展示顺序一致,即第一个同步组件为顶部展示元素
element_type
enum 原生页中组件类型,[枚举详情]
image_spec
struct 图片组件元素
image_id_list
string[] 图片 id 列表
video_spec
struct 视频组件元素
video_id
integer 视频 id,通过 [videos 模块] 上传视频后获得
text_spec
struct 文本组件元素
text
string 文本内容
button_spec
struct 按钮组件元素
title
string 按钮文案,具体长度以线下模板文档为主,按钮文案
url
string 跳转链接的 url,按钮组件元素时传入
app_ios_spec
struct iOS 应用信息元素
deep_link_url
string 应用直达页 url
app_ios_id
string iOS 应用 id
app_android_spec
struct Android 应用信息元素
deep_link_url
string 应用直达页 url
app_android_id
string Android 应用 id
app_android_channel_package_id
string Android 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取
mini_program_spec
struct 小程序信息,微信小程序信息
title
string 按钮文案
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
mini_game_program_spec
struct 小游戏信息,微信小游戏信息
title
string 按钮文案
mini_game_program_id
string 小程序 id
fengye_spec
struct 枫叶信息
title
string 按钮文案
fengye_id
string 枫叶落地页 id
card_spec
struct 卡券信息
title
string 按钮文案
card_id
string 微信卡券 id
follow_spec
struct 关注公众号信息
title
string 按钮文案
service_spec
struct 客服组建信息
title
string 按钮文案
form_spec
struct 表单组件元素
title
string 按钮文案,具体长度以线下模板文档为主,按钮文案
element_shelf
struct 图文复合组件
shelf_spec
struct[] 图文复合组件按钮信息,支持一行一个和一行两个
shelf_button_spec
struct 按钮信息
link_spec
struct 外链信息
title
string 按钮文案
url
string 跳转链接的 url,按钮组件元素时传入
app_download_spec
struct 应用下载信息
title
string 按钮文案
app_ios_spec
struct iOS 应用信息元素
deep_link_url
string 应用直达页 url
app_ios_id
string iOS 应用 id
app_android_spec
struct Android 应用信息元素
deep_link_url
string 应用直达页 url
app_android_id
string Android 应用 id
app_android_channel_package_id
string Android 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取
mini_program_spec
struct 小程序信息,微信小程序信息
title
string 按钮文案
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
image_id_list
string 图片 id,通过 [images 模块] 上传图片后获得
title
string 图文复合标题文案
悬浮组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。)
单排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。)
双排货架组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。)
desc
string 图文复合描述文案
悬浮组件:字段长度最小 1 个等宽字符,长度最大 14 个等宽字符(即字段最大长度为 14 个中文字或全角标点,28 个英文字或半角标点。)
单排货架组件:字段长度最小 1 个等宽字符,长度最大 15 个等宽字符(即字段最大长度为 15 个中文字或全角标点,30 个英文字或半角标点。)
双排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。)
element_float
struct 悬浮组件
image_id_list
string 图片 id,通过 [images 模块] 上传图片后获得
title
string 图文复合标题文案
悬浮组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。)
单排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。)
双排货架组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。)
desc
string 图文复合描述文案
悬浮组件:字段长度最小 1 个等宽字符,长度最大 14 个等宽字符(即字段最大长度为 14 个中文字或全角标点,28 个英文字或半角标点。)
单排货架组件:字段长度最小 1 个等宽字符,长度最大 15 个等宽字符(即字段最大长度为 15 个中文字或全角标点,30 个英文字或半角标点。)
双排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。)
float_button_spec
struct 悬浮组件按钮
link_spec
struct 外链信息
title
string 按钮文案
url
string 跳转链接的 url,按钮组件元素时传入
app_download_spec
struct 应用下载信息
title
string 按钮文案
app_ios_spec
struct iOS 应用信息元素
deep_link_url
string 应用直达页 url
app_ios_id
string iOS 应用 id
app_android_spec
struct Android 应用信息元素
deep_link_url
string 应用直达页 url
app_android_id
string Android 应用 id
app_android_channel_package_id
string Android 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取
mini_program_spec
struct 小程序信息,微信小程序信息
title
string 按钮文案
mini_program_id
string 小程序 id
mini_program_path
string 小程序路径
mini_game_program_spec
struct 小游戏信息,微信小游戏信息
title
string 按钮文案
mini_game_program_id
string 小程序 id
fengye_spec
struct 枫叶信息
title
string 按钮文案
fengye_id
string 枫叶落地页 id
card_spec
struct 卡券信息
title
string 按钮文案
card_id
string 微信卡券 id
follow_spec
struct 关注公众号信息
title
string 按钮文案
service_spec
struct 客服组建信息
title
string 按钮文案
element_goods
struct 商品组件
goods_button_spec
struct 商品按钮
title
string 按钮文案
share_content_spec
struct 分享信息,微信原生页分享信息
share_title
string 分享标题,具体长度以线下模板文档为主,分享标题
share_description
string 分享描述,具体长度以线下模板文档为主,分享描述
preview_url
string 微信原生页的预览地址,1 小时内有效
page_type
enum 落地页类型(page_type 字段已废弃,不再返回,预计在近期下线),[枚举详情]
source_type
enum 视频/图片等素材的创建来源类型,[枚举详情]
video_resource_status
enum 微信原生页视频资源状态,[枚举详情]
page_info
struct 分页配置信息
page
integer 搜索页码
page_size
integer 一页显示的数据条数
total_number
integer 总条数
total_page
integer 总页数

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "page_id": "<PAGE_ID>",
                "page_name": "test name",
                "created_time": 1491019858,
                "last_modified_time": 1491098468,
                "page_template_id": "<PAGE_TEMPLATE_ID>",
                "page_elements_spec_list": [
                    {
                        "element_type": "IMAGE",
                        "image_spec": {
                            "image_id_list": [
                                "4152626:583dfc8e7f53a58db8293622b78a3c7f"
                            ]
                        }
                    },
                    {
                        "element_type": "BUTTON",
                        "button_spec": {
                            "title": "拼多多模板 1",
                            "url": "http%3a%2f%2fjd.com",
                            "app_ios_spec": {
                                "deep_link_url": "pinduoduo%3a%2f%2fcom.xunmeng.pinduoduo%2fgoods.html%3fgoods_id%3d3163709495%26_p_ads_channel%3dweixin%26_p_launch_type%3dadv%26_p_ads_set%3dshangxiang%26account_id%3dwx95c952f67a727090",
                                "app_ios_id": "1044283059"
                            },
                            "app_android_spec": {
                                "deep_link_url": "pinduoduo%3a%2f%2fcom.xunmeng.pinduoduo%2fgoods.html%3fgoods_id%3d3163709495%26_p_ads_channel%3dweixin%26_p_launch_type%3dadv%26_p_ads_set%3dshangxiang%26account_id%3dwx95c952f67a727090",
                                "app_android_id": "1104790111",
                                "app_android_channel_package_id": "72243366;000116083635303838333533"
                            }
                        }
                    },
                    {
                        "element_type": "IMAGE",
                        "image_spec": {
                            "image_id_list": [
                                "1613822"
                            ]
                        }
                    },
                    {
                        "element_type": "IMAGE",
                        "image_spec": {
                            "image_id_list": [
                                "1613374"
                            ]
                        }
                    },
                    {
                        "element_type": "BUTTON",
                        "button_spec": {
                            "title": "拼多多模板 1",
                            "url": "http%3a%2f%2fjd.com",
                            "app_ios_spec": {
                                "deep_link_url": "pinduoduo%3a%2f%2fcom.xunmeng.pinduoduo%2fgoods.html%3fgoods_id%3d3163709495%26_p_ads_channel%3dweixin%26_p_launch_type%3dadv%26_p_ads_set%3dshangxiang%26account_id%3dwx95c952f67a727090",
                                "app_ios_id": "1044283059"
                            },
                            "app_android_spec": {
                                "deep_link_url": "pinduoduo%3a%2f%2fcom.xunmeng.pinduoduo%2fgoods.html%3fgoods_id%3d3163709495%26_p_ads_channel%3dweixin%26_p_launch_type%3dadv%26_p_ads_set%3dshangxiang%26account_id%3dwx95c952f67a727090",
                                "app_android_id": "1104790111",
                                "app_android_channel_package_id": "72243366;000116083635303838333533"
                            }
                        }
                    },
                    {
                        "element_type": "IMAGE",
                        "image_spec": {
                            "image_id_list": [
                                "1613374"
                            ]
                        }
                    },
                    {
                        "element_type": "BUTTON",
                        "button_spec": {
                            "title": "拼多多模板 1",
                            "url": "http%3a%2f%2fjd.com",
                            "app_ios_spec": {
                                "deep_link_url": "pinduoduo%3a%2f%2fcom.xunmeng.pinduoduo%2fgoods.html%3fgoods_id%3d3163709495%26_p_ads_channel%3dweixin%26_p_launch_type%3dadv%26_p_ads_set%3dshangxiang%26account_id%3dwx95c952f67a727090",
                                "app_ios_id": "1044283059"
                            },
                            "app_android_spec": {
                                "deep_link_url": "pinduoduo%3a%2f%2fcom.xunmeng.pinduoduo%2fgoods.html%3fgoods_id%3d3163709495%26_p_ads_channel%3dweixin%26_p_launch_type%3dadv%26_p_ads_set%3dshangxiang%26account_id%3dwx95c952f67a727090",
                                "app_android_id": "1104790111",
                                "app_android_channel_package_id": "72243366;000116083635303838333533"
                            }
                        }
                    }
                ],
                "share_content_spec": {
                    "share_title": "分享标题",
                    "share_description": "分享描述信息"
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

可视化调试工具