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

创建微信落地页
全部接口
V1.1
loading

所属权限 Ads Management
请求地址 wechat_pages/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
page_name*
string 落地页名称
字段长度最小 1 字节,长度最大 120 字节
page_template_id*
integer 落地页模板 id
page_elements_spec_list*
struct[] 组件素材内容,组件的同步顺序与原生页的展示顺序一致,即第一个同步组件为顶部展示元素
数组最大长度 32
element_type*
enum 原生页中组件类型,[枚举详情]
枚举列表:{ IMAGE, VIDEO, TEXT, BUTTON, FORM, CAROUSEL, ELEMENT_TYPE_UNSUPPORTED, CARD_ROTATE_IMAGE, SHELF, FLOAT_BUTTON, GOODS }
image_spec
struct 图片组件元素
image_id_list*
string[] 图片 id 列表
数组最小长度 1,最大长度 6
字段长度最小 1 字节,长度最大 64 字节
video_spec
struct 视频组件元素
video_id*
integer 视频 id,通过 [videos 模块] 上传视频后获得
text_spec
struct 文本组件元素
text*
string 文本内容
字段长度最小 1 字节,长度最大 4096 字节
button_spec
struct 按钮组件元素
title
string 按钮文案,具体长度以线下模板文档为主,按钮文案
字段长度最小 1 字节,长度最大 120 字节
url
string 跳转链接的 url,按钮组件元素时传入
字段长度最小 1 字节,长度最大 250 字节
app_ios_spec
struct iOS 应用信息元素
deep_link_url
string 应用直达页 url
字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*
string iOS 应用 id
字段长度最小 1 字节,长度最大 128 字节
app_android_spec
struct Android 应用信息元素
deep_link_url
string 应用直达页 url
字段长度最小 0 字节,长度最大 2048 字节
app_android_id*
string Android 应用 id
字段长度最小 1 字节,长度最大 128 字节
app_android_channel_package_id
string Android 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取
字段长度最小 0 字节,长度最大 128 字节
mini_program_spec
struct 小程序信息,微信小程序信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
mini_program_id*
string 小程序 id
字段长度最小 1 字节,长度最大 384 字节
mini_program_path*
string 小程序路径
字段长度最小 1 字节,长度最大 2048 字节
mini_game_program_spec
struct 小游戏信息,微信小游戏信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
mini_game_program_id*
string 小程序 id
字段长度最小 1 字节,长度最大 384 字节
fengye_spec
struct 枫叶信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
fengye_id*
string 枫叶落地页 id
字段长度最小 1 字节,长度最大 384 字节
card_spec
struct 卡券信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
card_id*
string 微信卡券 id
字段长度最小 1 字节,长度最大 384 字节
follow_spec
struct 关注公众号信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
service_spec
struct 客服组建信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
form_spec
struct 表单组件元素
title*
string 按钮文案,具体长度以线下模板文档为主,按钮文案
字段长度最小 1 字节,长度最大 30 字节
element_shelf
struct 图文复合组件
shelf_spec
struct[] 图文复合组件按钮信息,支持一行一个和一行两个
数组最大长度 32
shelf_button_spec*
struct 按钮信息
link_spec
struct 外链信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
url
string 跳转链接的 url,按钮组件元素时传入
字段长度最小 1 字节,长度最大 250 字节
app_download_spec
struct 应用下载信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
app_ios_spec
struct iOS 应用信息元素
deep_link_url
string 应用直达页 url
字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*
string iOS 应用 id
字段长度最小 1 字节,长度最大 128 字节
app_android_spec
struct Android 应用信息元素
deep_link_url
string 应用直达页 url
字段长度最小 0 字节,长度最大 2048 字节
app_android_id*
string Android 应用 id
字段长度最小 1 字节,长度最大 128 字节
app_android_channel_package_id
string Android 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取
字段长度最小 0 字节,长度最大 128 字节
mini_program_spec
struct 小程序信息,微信小程序信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
mini_program_id*
string 小程序 id
字段长度最小 1 字节,长度最大 384 字节
mini_program_path*
string 小程序路径
字段长度最小 1 字节,长度最大 2048 字节
image_id_list*
string 图片 id,通过 [images 模块] 上传图片后获得
字段长度最小 1 字节,长度最大 64 字节
title*
string 图文复合标题文案
悬浮组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。)
单排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。)
双排货架组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。)
字段长度最小 1 字节,长度最大 120 字节
desc*
string 图文复合描述文案
悬浮组件:字段长度最小 1 个等宽字符,长度最大 14 个等宽字符(即字段最大长度为 14 个中文字或全角标点,28 个英文字或半角标点。)
单排货架组件:字段长度最小 1 个等宽字符,长度最大 15 个等宽字符(即字段最大长度为 15 个中文字或全角标点,30 个英文字或半角标点。)
双排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。)
字段长度最小 1 字节,长度最大 120 字节
element_float
struct 悬浮组件
image_id_list*
string 图片 id,通过 [images 模块] 上传图片后获得
字段长度最小 1 字节,长度最大 64 字节
title*
string 图文复合标题文案
悬浮组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。)
单排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。)
双排货架组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。)
字段长度最小 1 字节,长度最大 120 字节
desc*
string 图文复合描述文案
悬浮组件:字段长度最小 1 个等宽字符,长度最大 14 个等宽字符(即字段最大长度为 14 个中文字或全角标点,28 个英文字或半角标点。)
单排货架组件:字段长度最小 1 个等宽字符,长度最大 15 个等宽字符(即字段最大长度为 15 个中文字或全角标点,30 个英文字或半角标点。)
双排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。)
字段长度最小 1 字节,长度最大 120 字节
float_button_spec*
struct 悬浮组件按钮
link_spec
struct 外链信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
url
string 跳转链接的 url,按钮组件元素时传入
字段长度最小 1 字节,长度最大 250 字节
app_download_spec
struct 应用下载信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
app_ios_spec
struct iOS 应用信息元素
deep_link_url
string 应用直达页 url
字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*
string iOS 应用 id
字段长度最小 1 字节,长度最大 128 字节
app_android_spec
struct Android 应用信息元素
deep_link_url
string 应用直达页 url
字段长度最小 0 字节,长度最大 2048 字节
app_android_id*
string Android 应用 id
字段长度最小 1 字节,长度最大 128 字节
app_android_channel_package_id
string Android 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取
字段长度最小 0 字节,长度最大 128 字节
mini_program_spec
struct 小程序信息,微信小程序信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
mini_program_id*
string 小程序 id
字段长度最小 1 字节,长度最大 384 字节
mini_program_path*
string 小程序路径
字段长度最小 1 字节,长度最大 2048 字节
mini_game_program_spec
struct 小游戏信息,微信小游戏信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
mini_game_program_id*
string 小程序 id
字段长度最小 1 字节,长度最大 384 字节
fengye_spec
struct 枫叶信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
fengye_id*
string 枫叶落地页 id
字段长度最小 1 字节,长度最大 384 字节
card_spec
struct 卡券信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
card_id*
string 微信卡券 id
字段长度最小 1 字节,长度最大 384 字节
follow_spec
struct 关注公众号信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
service_spec
struct 客服组建信息
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
element_goods
struct 商品组件
goods_button_spec*
struct 商品按钮
title*
string 按钮文案
字段长度最小 1 字节,长度最大 120 字节
share_content_spec*
struct 分享信息,微信原生页分享信息
share_title*
string 分享标题,具体长度以线下模板文档为主,分享标题
字段长度最小 1 字节,长度最大 10240 字节
share_description*
string 分享描述,具体长度以线下模板文档为主,分享描述
字段长度最小 1 字节,长度最大 10240 字节

使用说明

  1. 不同模板要求同步的组件顺序,填写的组件字段以及字段要求不同,具体请参见模板说明文档。

请求示例


curl 'https://api.e.qq.com/v1.1/wechat_pages/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'page_name=test name' \
-d 'page_template_id=<PAGE_TEMPLATE_ID>' \
-d '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"}}}]' \
-d 'share_content_spec={"share_title":"分享标题","share_description":"分享描述信息"}' 
					

应答字段

名称 类型 描述
page_id
integer 落地页 id

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "page_id": "<PAGE_ID>"
    }
}

可视化调试工具