腾讯广告
  1. 微信原生页
腾讯广告
  • 入门与指南
    • 快速入门
    • 术语介绍和技术准备
    • 业务流程
    • 发起请求
    • 接收应答
    • 接口清单
    • V1.3升级指引
  • 授权认证
    • OAuth授权
      • 获取 Authorization Code
      • 获取 Token
  • 账号管理
    • 广告账号
      • 添加腾讯广告服务商子客
      • 更新腾讯广告广告主信息
      • 查询腾讯广告广告主信息
      • 获取竞价广告账户日预算
      • 查询商务管家账号下广告主信息
      • 查询商务管家或同主体下广告主信息
    • 资质
      • 创建广告主资质
      • 更新广告主资质
      • 获取广告主资质
      • 删除广告主资质
    • 资金账户
      • 发起代理商与子客户之间转账
      • 获取资金账户信息
      • 获取资金账户日结明细
      • 获取资金账户日结明细(新,包含日终结余数据)
      • 获取资金流水
      • 获取微信资金账户信息
      • 获取微信资金账户流水信息
      • 获取实时消耗
      • 服务商当日分账户实时消耗
      • 服务商内部划账
      • 同商务管家子客间转账
      • 资金合并类型同商务管家子客间转账
      • 获取资金合并类型资金账户信息
      • 获取资金合并类型资金账户日结明细
      • 获取资金合并类型资金流水
  • 营销资产
    • 推广目标
      • 创建推广目标
      • 更新推广目标
      • 获取推广目标
      • 删除推广目标
      • 推广目标授权接口
      • 获取授权历史记录
      • 获取 Android 渠道包
    • 落地页
      • 获取落地页列表
      • 获取蹊径落地页模板列表
      • 获取蹊径落地页模板
      • 获取蹊径落地页互动模板配置
      • 蹊径-获取落地页列表
      • 蹊径-基于模板创建落地页
      • 蹊径-基于组件创建落地页
      • 蹊径-创建互动落地页
      • 蹊径-送审落地页
      • 蹊径-删除落地页
      • 生成虚拟人
      • 生成点击特效
      • 生成预览 token
    • 落地页号码包
      • 获取蹊径号码包列表
      • 添加蹊径号码包
      • 更新蹊径号码包
      • 获取蹊径微信号列表
      • 更新蹊径微信号
    • 视频
      • 添加视频文件
      • 获取视频文件
      • 修改视频信息
      • 删除视频
    • 图片
      • 添加图片文件
      • 获取图片信息
      • 修改图片信息
      • 删除图片
    • 品牌形象
      • 创建品牌形象
      • 获取品牌形象列表
    • 互动推广页
      • 获取互动推广页
    • 商品库
      • 创建商品库
      • 获取商品库
      • 添加商品
      • 行业列表
      • 获取商品
      • 获取商品详情
      • 更新商品信息
      • 批量更新商品信息
      • 获取审核失败的商品
      • 获取商品类目
      • 创建商品系列
      • 获取商品系列
    • 动态商品图片
      • 创建用于广告投放的动态广告图片
      • 获取动态广告图片信息
    • 动态商品视频
      • 创建用于广告投放的动态广告视频
    • 微信原生页
      • 基于模板创建微信原生页
        POST
      • 基于组件创建微信原生页
        POST
      • 获取微信落地页列表
        GET
      • 删除微信落地页
        POST
    • 广告应用分包
      • 创建应用分包
      • 更新应用子包版本
      • 查询应用分包列表
    • 优量汇流量包
      • 联盟流量包模块
      • 联盟流量包模块
      • 联盟流量包获取接口
      • 联盟流量包删除接口
    • 资产授权
      • 资产权限授予
      • 资产权限回收
      • 获取待确认接收授权列表接口
      • 资产预授权确认
      • 更新资产授权权限
    • 朋友圈头像昵称跳转页
      • 创建朋友圈头像昵称跳转页
      • 删除朋友圈头像昵称跳转页
      • 获取朋友圈头像昵称跳转页
    • 附加创意
      • 创建表单组件
      • 获取表单组件详情
      • 获取表单组件列表
    • 弹幕
      • 添加弹幕
      • 获取弹幕
      • 查询运营推荐弹幕列表
    • 本地门店
      • 批量录入门店
      • 批量更新门店信息
      • 批量删除门店信息
      • 查询门店信息
      • 解析门店地址
      • 搜索门店
      • 查询微信支付商户号
      • 查询门店类目
    • 创意组件
      • 创建创意组件
      • 更新创意组件
      • 查询创意组件信息
      • 删除创意组件
      • 更新创意组件状态
  • 广告管理
    • 推广计划
      • 创建推广计划
      • 更新推广计划
      • 获取推广计划
      • 删除推广计划
    • 广告组
      • 创建广告组
      • 更新广告组
      • 获取广告组
      • 删除广告组
    • 广告创意
      • 创建广告创意
      • 更新广告创意
      • 获取广告创意
      • 删除广告创意
    • 动态创意
      • 创建动态创意
      • 更新动态创意
      • 获取动态创意
    • 广告
      • 创建广告
      • 更新广告
      • 获取广告
      • 删除广告
    • 定向
      • 创建定向
      • 更新定向
      • 获取定向
      • 删除定向
      • 分享定向
      • 获取定向分享记录
    • 关键词
      • 创建关键词
      • 替换关键词
      • 删除关键词
      • 获取关键词
    • 否定词
      • 新增推广计划否定词
      • 新增广告组否定词
      • 修改推广计划否定词
      • 修改广告组否定词
      • 查询推广计划否定词
      • 查询广告组否定词
    • 批量操作
      • 创建批量请求
      • 更新广告主日限额信息
      • 更新推广计划日限额信息
      • 更新广告组日限额信息
      • 更新推广计划状态
      • 更新广告组状态
      • 更新广告状态
      • 更新广告组投放时间
      • 更新广告组出价
      • 创建批量异步请求任务
      • 获取批量异步请求任务列表
      • 获取批量异步请求任务详情
    • 出价
      • 获取分人群出价标签
  • 创意工具
    • 文案助手
      • 获取广告文案
    • 图片处理
      • 进行图片处理
    • 广告素材预审
      • 获取广告素材预审结果
    • 视频加字幕
      • 创建视频加字幕任务
    • 创建智能调整
      • 创建智能调整任务
    • 视频封面画图
      • 生成视频封面图
    • 词包
      • 获取词包
    • 通配符
      • 获取落地页通配符
    • 创意示例商品
      • 获取创意示例商品列表
    • 动态商品图片模板
      • 获取动态商品图片模板
    • 动态商品视频模板
      • 获取动态商品视频模板
    • 创意工具通用接口
      • 视频工具任务查询
    • 自动生成创意
      • 创建模板预览接口
      • 更新模板预览接口
      • 获取模板预览接口
      • 获取模板列表接口
    • 素材标签
      • 素材标签列表
      • 素材标签保存
  • 数据洞察
    • 广告数据洞察
      • 获取日报表
      • 获取小时报表
      • 获取定向标签报表
      • 落地页报表数据接口
      • 联盟广告位报表接口
      • 视频流失分析接口
      • 创建异步报表任务
      • 获取异步报表任务
      • 获取文件接口
    • 人群数据洞察
      • 人群洞察分析
    • 订单数据
      • 获取订单
      • 更新订单
    • 线索管理平台
      • 获取线索列表
      • 回传线索状态
      • 获取中间号
      • 获取通话结果
      • 获取一个账号下的全部通话结果
      • 获取网络电话 token
      • 网络电话呼叫
      • 外部线索数据导入
      • 外部线索状态更新
      • 更新线索基本信息
      • 获取无效赔付明细
    • 人群价值分析
      • 人群价值分析
  • 人群管理
    • 客服人群
      • 创建客户人群
      • 更新客户人群
      • 更新客户人群
      • 删除客户人群
    • 客户人群数据文件
      • 上传客户人群数据文件
      • 获取客户人群数据文件
    • 客户人群数预估
      • 人群覆盖数预估
    • 人群授权
      • 添加人群授权
      • 获取人群授权信息
    • 标签人群
      • 标签广场标签获取
    • 客户标签
      • 创建客户标签
      • 获取客户标签
      • 更新客户标签
      • 删除客户标签
    • 标签数据文件
      • 上传客户标签人群数据文件
      • 获取客户标签人群文件
    • 用户属性数据源
      • 创建用户属性数据源
      • 更新用户属性数据源
      • 获取用户属性数据源
    • 用户属性数据
      • 上传用户属性数据
  • 数据上报
    • 用户行为数据源
      • 创建用户行为数据源
      • 获取用户行为数据源
      • 获取用户行为数据源报表
      • 添加数据集
      • 获取数据集
      • 数据源分发关系更新
      • 数据源分发关系获取
    • 用户行为数据
      • 上传用户行为数据
    • 属性数据源
      • 创建属性数据源
      • 获取属性数据源
    • 属性数据源schema
      • 创建属性数据源 schema
      • 更新属性数据源 schema
      • 获取属性数据源 Schema
    • 属性数据文件上传
      • 创建属性数据文件上传会话
      • 提交属性数据文件上传会话
      • 上传属性数据文件
  • 附近推
    • 附近推开户
      • 附近推商家开户
      • 更新附近推商家信息
      • 查询附近推商家信息
    • 附近推账户资金
      • 微信服务商子客之间转账
    • 附近推账户资质
      • 添加附近推商家资质
      • 删除附近推商家资质
      • 查询附近推商家资质信息
    • 附近推广告投放
      • 创建广告
      • 拉取广告列表
      • 更新广告
      • 手动结束广告
      • 拉取曝光预估数据
    • 附近推门店
      • 批量录入门店
      • 批量更新门店信息
      • 批量删除门店信息
      • 查询门店信息
      • 解析门店地址
      • 搜索门店
      • 查询微信支付商户号
      • 查询门店类目
  • 审核工具
    • 素材风险检测
      • 获取元素的预审结果
    • 广告申诉复审
      • 发起广告申诉复审
      • 获取广告申诉复审结果
      • 获取广告申诉复审配额
  • 投放辅助工具
    • 定向标签
      • 获取定向标签
      • 获取行为/兴趣/意向标签覆盖人群数
    • 场景定向标签
      • 获取场景定向标签
    • 创意形式
      • 获取创意规格详情
      • 获取创意规格列表
    • 广告投放能力
      • 查询优化目标权限
    • 预估能力
      • 人数预估
      • 获取出价模拟信息
      • 获取当日转化效果预估数据
    • 广告预览
      • 创建预览
      • 获取预览受众
      • 获取广告预览二维码
    • ·异步任务
      • 创建异步任务
      • 获取异步任务
      • 获取文件接口
    • 拆分对比实验
      • 创建拆分对比实验
      • 更新拆分对比实验
      • 删除拆分对比实验
      • 获取拆分对比实验
    • 广告诊断
      • 获取广告诊断信息
    • 广告创意预览
      • 获取广告创意预览
    • 微信广告标签
      • 获取微信广告标签
    • 广告标签
      • 获取广告标签
    • 转化归因
      • 新增转化归因
      • 获取转化归因
    • 微信原生页
      • 获取原生页授权方信息
      • 获取企业微信客服组列表
      • 增加企业微信组件客服组
      • 更新企业微信组件客服组
      • 获取企业微信组件客服列表
      • 更新企业微信组件客服状态
    • 微信公众号账户升级
      • 获取微信公众号账户升级状态
    • 腾讯广告账户报表指标升级
      • 获取腾讯广告平台广告账户升级状态
    • 探索推广工具
      • 查询关键词流量接口
      • 获取关键词推荐结果
      • 查询行业业务点信息
    • 视频号精选评论管理
      • 设置视频号评论管理
    • 游戏特征信息
      • 获取游戏特征标签
      • 新增游戏 app 特征
      • 更新游戏 app 特征
      • 获取游戏 app 特征
  • 附录
    • 更多信息
  1. 微信原生页

基于组件创建微信原生页

开发环境
开发环境
POST
/v1.3/wechat_pages_custom/add

请求参数

标有*的参数为必填项

名称类型描述
account_id*integer推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id
page_name*string落地页名称 字段长度最小 1 字节,长度最大 120 字节
page_specs_list*struct[]页面列表,页面顺序与生成的原生页的顺序一致
bg_colorstring背景颜色 字段长度为 7 字节
page_elements_spec_list*struct[]页面组件列表, 页面顺序与生成的原生页的顺序一致
element_type*enum原生页中组件类型,[枚举详情] 枚举列表:{ TOP_IMAGE, TOP_SLIDER, TOP_VIDEO, IMAGE, SLIDER, VIDEO, TEXT, APP_DOWNLOAD, WEAPP, GH, ENTERPRISE_WX, IMAGE_TEXT }
top_image_specstruct顶部图片组件元素 图片大小: 不超过 300KB 图片尺寸: 朋友圈常规广告 800800, 朋友圈卡片广告 800450. 公众号及其他广告位 800800/640800/800640/800450
image_id*int64图片 id. 通过 [images 模块] 上传图片后获得 字段长度最小 1 字节,长度最大 20 字节
width*integer图片宽度
height*integer图片高度
ad_location*string广告位, sns 代表朋友圈, gzh 代表公众号 字段长度为 3 字节
outer_styleintegerad_location 为 sns 时必填. 取值 0: 常规广告, 1: 卡片广告 最小值 0,最大值 1
top_slider_specstruct顶部轮播图组件元素 图片大小: 不超过 300KB 图片尺寸: 800*800
image_id_list*string[]图片 id 列表, 个数为 3,4,6. 数组最小长度 3,最大长度 6
width*integer图片宽度
height*integer图片高度
top_video_specstruct顶部视频组件元素 视频时长 6-90 秒. 视频尺寸: 朋友圈常规 640480/640360/7501536/7501334/7201280/1280720/1280960, 微信平台账号:朋友圈基础卡片广告:640360/7501536, 朋友圈全福式卡片广告:750<=1536 腾讯广告账号:卡片广告:640360 公众号及其他:750<=1536
video_id*int64视频 id, 通过 [videos 模块] 上传视频后获得 字段长度最小 1 字节,长度最大 20 字节
width*integer视频宽度
height*integer视频高度
ad_location*string广告位, sns 代表朋友圈, gzh 代表公众号 字段长度为 3 字节
outer_styleintegerad_location 为 sns 时必填 取值 0: 常规广告, 1: 基础卡片广告, 2: 全幅卡片广告 最小值 0,最大值 2
used_for_outerinteger仅微信平台账号有效. outer_style=1 时选填 取值 0:顶部素材用于广告外层, 1:顶部素材不用于广告外层. 默认 0. 最小值 0,最大值 1
image_specstruct基础图片组件元素 图片大小: 不超过 300KB 图片尺寸: 宽度 750, 高度不超过 1536
image_id*int64图片 id. 通过 [images 模块] 上传图片后获得 字段长度最小 1 字节,长度最大 20 字节
width*integer图片宽度
height*integer图片高度
padding_topinteger距离上一个组件距离. 默认值 0 最小值 0,最大值 100
padding_bottominteger距离下一个组件距离. 默认值 0 最小值 0,最大值 100
slider_specstruct基础轮播图组件元素 图片尺寸: 普通轮播样式: 750*(300-1125), 卡片轮播样式: 512*(288-920)
image_id_list*string[]图片 id 列表, 个数为 2,3,4,5. 数组最小长度 2,最大长度 5
width*integer图片宽度
height*integer图片高度
slider_style*integer轮播图样式. 0: 普通样式, 1: 卡片样式 最小值 0,最大值 1
bg_colorstring轮播背景颜色. slider_style=1 时有效. 默认#FFFFFF 字段长度为 7 字节
video_specstruct基础视频组件元素 视频时长 1-30 秒. 视频大小不超过 20MB. 视频尺寸: 750*<=1536
video_id*int64视频 id, 通过 [videos 模块] 上传视频后获得 字段长度最小 1 字节,长度最大 20 字节
width*integer视频宽度
height*integer视频高度
in_middleinteger是否居中显示. 要求视频单独占用一页. 设置后视频可在页面上下居中显示 取值 0:不居中,1:居中. 默认 0. 最小值 0,最大值 1
text_specstruct基础文本组件元素
text*string文本内容 字段长度最小 1 字节,长度最大 30000 字节
padding_topinteger距离上一个组件距离. 默认值 22 最小值 0,最大值 100
padding_bottominteger距离下一个组件距离. 默认值 22 最小值 0,最大值 100
font_sizeinteger字体大小 取值 14, 15, 16, 18, 20, 24, 36. 默认 15 最小值 14,最大值 36
font_colorstring字体颜色. 默认#595959 字段长度为 7 字节
text_alignmentinteger对齐方式 取值 0: left, 1: middle, 2: right. 默认 0 最小值 0,最大值 2
font_styleinteger字体样式 取值 0: 常规, 1: 加粗. 默认 0 最小值 0,最大值 1
app_download_specstruct应用下载组件元素
title*string按钮文案 审核规范:原生页当含有 app_android_spec 或 app_ios_spec 元素时,下载按钮文案必须含有“安装”或“下载”才允许使用 字段长度最小 1 字节,长度最大 30 字节
font_colorstring下载按钮字体颜色. 默认#FFFFFF 字段长度为 7 字节
bg_colorstring下载按钮填充色. 默认#07C160 字段长度为 7 字节
padding_topinteger距离上一个组件距离. 默认值 28 最小值 0,最大值 100
padding_bottominteger距离下一个组件距离. 默认值 28 最小值 0,最大值 100
app_ios_specstruct应用下载 iOS 元素
app_ios_id*stringiOS 应用 id 字段长度最小 1 字节,长度最大 128 字节
deep_link_urlstring应用直达页 url 字段长度最小 1 字节,长度最大 1024 字节
jump_appstore_typeinteger点击按钮跳转. 取值 0: 外跳 appstore, 1: 内跳 appstore, 默认 0 最小值 0,最大值 1
app_android_specstruct应用下载 Android 元素
app_android_id*stringAndroid 应用 id 字段长度最小 1 字节,长度最大 128 字节
deep_link_urlstring应用直达页 url 字段长度最小 1 字节,长度最大 1024 字节
app_android_channel_package_idstringAndroid 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取 字段长度最小 1 字节,长度最大 128 字节
app_market_packagestring跳转应用商店下载使用的 pkg name 字段长度最小 1 字节,长度最大 500 字节
weapp_specstruct进入小程序组件元素
weapp_username*string小程序原始 id 字段长度最小 1 字节,长度最大 50 字节
weapp_path*string小程序路径 字段长度最小 1 字节,长度最大 250 字节
btn_titlestring按钮文案, use_icon 为 0 时,长度限制 1-10 ; use_icon 为 1 时,长度限制 1-8 ; 不支持 emoji 表情,英文算半个字符。 默认:进入小程序 字段长度最小 1 字节,长度最大 10 字节
btn_border_color_themestring边框色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_bg_color_themestring按钮填充色,#000000-#FFFFFF,默认#07C160 字段长度为 7 字节
font_colorstring按钮文案颜色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_font_typeinteger按钮文案配置 取值 0: 常规, 1: 加粗. 默认 0 最小值 0,最大值 1
use_iconinteger是否使用图标 取值 0: 不使用图标, 1: 使用图标. 默认 0 最小值 0,最大值 1
padding_topinteger上边距. 默认值 28 最小值 0,最大值 100
padding_bottominteger下边距. 默认值 28 最小值 0,最大值 100
gh_specstruct关注公众号组件元素
fast_followinteger是否开启一键关注, 取值 0: 关闭, 1: 开启. 默认 1 最小值 0,最大值 1
btn_titlestring按钮文案, use_icon 为 0 时,长度限制 1-10 ; use_icon 为 1 时,长度限制 1-8 ; 不支持 emoji 表情,英文算半个字符。 默认:关注公众号 字段长度最小 1 字节,长度最大 10 字节
font_colorstring按钮文案颜色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_bg_color_themestring按钮填充色,#000000-#FFFFFF,默认#07C160 字段长度为 7 字节
btn_border_color_themestring边框色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_font_typeinteger按钮文案配置 取值 0: 常规, 1: 加粗. 默认 0 最小值 0,最大值 1
padding_topinteger上边距. 默认值 28 最小值 0,最大值 100
padding_bottominteger下边距. 默认值 28 最小值 0,最大值 100
use_iconinteger是否使用图标 取值 0: 不使用图标, 1: 使用图标. 默认 0 最小值 0,最大值 1
enterprise_wx_specstruct添加商家微信组件元素
corp_id*string绑定的企业 id
group_id*integer客服组 id 最小值 0,最大值 999999999
btn_titlestring按钮文案, use_icon 为 0 时,长度限制 1-10 ; use_icon 为 1 时,长度限制 1-8 ; 不支持 emoji 表情,英文算半个字符。 默认:联系商家 字段长度最小 1 字节,长度最大 10 字节
font_colorstring按钮文案颜色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_bg_color_themestring按钮填充色,#000000-#FFFFFF,默认#07C160 字段长度为 7 字节
btn_border_color_themestring边框色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_font_typeinteger按钮文案配置 取值 0: 常规, 1: 加粗. 默认 0 最小值 0,最大值 1
padding_topinteger上边距. 默认值 28 最小值 0,最大值 100
padding_bottominteger下边距. 默认值 28 最小值 0,最大值 100
use_iconinteger是否使用图标 取值 0: 不使用图标, 1: 使用图标. 默认 0 最小值 0,最大值 1
image_text_specstruct图文复合组件元素
padding_topinteger上边距. 默认值 20 最小值 0,最大值 100
padding_bottominteger下边距. 默认值 20 最小值 0,最大值 100
align_modeinteger两个商品的对其方式,0 左对齐,1 居中对齐,只有选一行 2 个的时候才生效. 默认值 0 最小值 0,最大值 1
image_text_item*struct[]图文复合组件配置
border_colorstring边框色,#000000-#FFFFFF,默认#e5e5e5 字段长度为 7 字节
title_colorstring标题颜色,#000000-#FFFFFF. 默认#353535 字段长度为 7 字节
desc_colorstring描述颜色,#000000-#FFFFFF. 默认#b2b2b2 字段长度为 7 字节
bg_colorstring背景颜色,#000000-#FFFFFF. 默认#ffffff 字段长度为 7 字节
jump_modeenum图文复合组件跳转方式,默认为 btn_jump,[枚举详情] 枚举列表:{ btn_jump, total_jump }
material_id*string素材 id 字段长度最小 1 字节,长度最大 16 字节
title*string标题, 一行一个商品,长度限制 1-12 ; 一行二个商品,长度限制 1-8 ; 字段长度最小 1 字节,长度最大 10 字节
desc*string描述, 一行一个商品,长度限制 1-15 ; 一行二个商品,长度限制 1-10 ; 字段长度最小 1 字节,长度最大 10 字节
sub_elem_type*enum图文复合组件转化类型,[枚举详情] 枚举列表:{ GH, ENTERPRISE_WX }
gh_specstruct关注公众号组件元素
fast_followinteger是否开启一键关注, 取值 0: 关闭, 1: 开启. 默认 1 最小值 0,最大值 1
btn_titlestring按钮文案, 长度限制 1-5 ; 不支持 emoji 表情,英文算半个字符。 默认:关注公众号 字段长度最小 1 字节,长度最大 10 字节
font_colorstring按钮文案颜色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_bg_color_themestring按钮填充色,#000000-#FFFFFF,默认#07C160 字段长度为 7 字节
btn_font_typeinteger按钮文案配置 取值 0: 常规, 1: 加粗. 默认 0 最小值 0,最大值 1
enterprise_wx_specstruct添加商家微信组件元素
corp_id*string绑定的企业 id
group_id*integer客服组 id 最小值 0,最大值 999999999
btn_titlestring按钮文案, 长度限制 1-5 ; 不支持 emoji 表情,英文算半个字符。 默认:联系商家 字段长度最小 1 字节,长度最大 10 字节
font_colorstring按钮文案颜色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_bg_color_themestring按钮填充色,#000000-#FFFFFF,默认#07C160 字段长度为 7 字节
btn_font_typeinteger按钮文案配置 取值 0: 常规, 1: 加粗. 默认 0 最小值 0,最大值 1
global_specstruct全局元素配置
global_elements_spec_list*struct[]全局组件列表, 组件顺序与生成的原生页的顺序一致
element_type*enum全局组件类型,[枚举详情] 枚举列表:{ FLOAT_BUTTON, SIDE_BAR_FLOAT_BUTTON }
float_button_specstruct悬浮组件元素
style_type*integer悬浮组件样式 取值 0: 图片+title+desc,1: title+desc, 2: title 最小值 0
image_idint64style_type=0 时必填. 悬浮组件图片 id. 图片尺寸 96x96 字段长度最小 1 字节,长度最大 20 字节
title*string悬浮组件标题 字段长度最小 1 字节,长度最大 30 字节
title_colorstring悬浮组件标题颜色. 默认#171717 字段长度为 7 字节
descstring悬浮组件描述. style_type=0,1 时必填 字段长度最小 1 字节,长度最大 42 字节
desc_colorstring悬浮组件描述颜色. 默认#4C4C4C 字段长度为 7 字节
appear_typeinteger出现方式 取值 0. 进入页面时出现, 1. 滑动页面时出现. 默认 0 如果 page_specs_list 只有一页必须为 0 最小值 0,最大值 1
disappear_typeinteger消失方式 取值 0.不消失, 1.滑至页面底部时消失, 默认 0 如果 page_specs_list 只有一页必须为 0 最小值 0,最大值 1
forbid_page_listinteger[]悬浮按钮不出现的页面数组. [1,2]代表第 1,2 页不出现悬浮按钮, 依次类推. 数组最小长度 1, 最小值 1
element_type*enum悬浮按钮内组件类型,[枚举详情] 枚举列表:{ APP_DOWNLOAD, WEAPP, GH, ENTERPRISE_WX }
app_download_specstruct应用下载组件元素
title*string按钮文案 审核规范:原生页当含有 app_android_spec 或 app_ios_spec 元素时,下载按钮文案必须含有“安装”或“下载”才允许使用 字段长度最小 1 字节,长度最大 15 字节
font_colorstring下载按钮字体颜色. 默认#FFFFFF 字段长度为 7 字节
bg_colorstring下载按钮填充色. 默认#07C160 字段长度为 7 字节
app_ios_specstruct应用下载 iOS 元素
app_ios_id*stringiOS 应用 id 字段长度最小 1 字节,长度最大 128 字节
deep_link_urlstring应用直达页 url 字段长度最小 1 字节,长度最大 1024 字节
jump_appstore_typeinteger点击按钮跳转. 取值 0: 外跳 appstore, 1: 内跳 appstore, 默认 0 最小值 0,最大值 1
app_android_specstruct应用下载 Android 元素
app_android_id*stringAndroid 应用 id 字段长度最小 1 字节,长度最大 128 字节
deep_link_urlstring应用直达页 url 字段长度最小 1 字节,长度最大 1024 字节
app_android_channel_package_idstringAndroid 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取 字段长度最小 1 字节,长度最大 128 字节
app_market_packagestring跳转应用商店下载使用的 pkg name 字段长度最小 1 字节,长度最大 500 字节
weapp_specstruct进入小程序组件元素
weapp_username*string小程序原始 id 字段长度最小 1 字节,长度最大 50 字节
weapp_path*string小程序路径 字段长度最小 1 字节,长度最大 250 字节
btn_titlestring按钮文案, 长度限制 1-5 ; 不支持 emoji 表情,英文算半个字符。 默认:进入小程序 字段长度最小 1 字节,长度最大 10 字节
btn_bg_color_themestring按钮填充色,#000000-#FFFFFF,默认#07C160 字段长度为 7 字节
font_colorstring按钮文案颜色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_font_typeinteger按钮文案配置 取值 0: 常规, 1: 加粗. 默认 0 最小值 0,最大值 1
gh_specstruct关注公众号组件元素
fast_followinteger是否开启一键关注, 取值 0: 关闭, 1: 开启. 默认 1 最小值 0,最大值 1
btn_titlestring按钮文案, 长度限制 1-5 ; 不支持 emoji 表情,英文算半个字符。 默认:关注公众号 字段长度最小 1 字节,长度最大 10 字节
font_colorstring按钮文案颜色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_bg_color_themestring按钮填充色,#000000-#FFFFFF,默认#07C160 字段长度为 7 字节
btn_font_typeinteger按钮文案配置 取值 0: 常规, 1: 加粗. 默认 0 最小值 0,最大值 1
enterprise_wx_specstruct添加商家微信组件元素
corp_id*string绑定的企业 id
group_id*integer客服组 id 最小值 0,最大值 999999999
btn_titlestring按钮文案, 长度限制 1-5 ; 不支持 emoji 表情,英文算半个字符。 默认:联系商家 字段长度最小 1 字节,长度最大 10 字节
font_colorstring按钮文案颜色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_bg_color_themestring按钮填充色,#000000-#FFFFFF,默认#07C160 字段长度为 7 字节
btn_font_typeinteger按钮文案配置 取值 0: 常规, 1: 加粗. 默认 0 最小值 0,最大值 1
side_bar_float_specstruct侧边悬浮组件元素
wordingstring按钮上的文字,可修改. 当 elem_type=TEL 时,默认为【一键拨号】; 当 elem_type=WX_SERVICE 时,默认为【微信客服】; 当 elem_type=ENTERPRISE_WX 时,默认为【商家微信】; 字段长度最小 1 字节,长度最大 4 字节
title_colorstring字体颜色,#000000-#FFFFFF. 默认#000000 字段长度为 7 字节
elem_type*enum侧边悬浮组件转化类型,[枚举详情] 枚举列表:{ TEL, WX_SERVICE, ENTERPRISE_WX }
tel_spec*struct一键拨号的参数结构
phone_number*string电话 字段长度最小 1 字节,长度最大 11 字节
phone_type*string电话类型,0:固话,1:手机 字段长度为 1 字节
wechat_service_spec*struct微信客服元素
wechat_service_url*string微信客服 url 字段长度最小 1 字节,长度最大 1024 字节
enterprise_wx_spec*struct添加商家微信组件元素
corp_id*string绑定的企业 id
group_id*integer客服组 id 最小值 0,最大值 999999999
btn_titlestring按钮文案, use_icon 为 0 时,长度限制 1-10 ; use_icon 为 1 时,长度限制 1-8 ; 不支持 emoji 表情,英文算半个字符。 默认:联系商家 字段长度最小 1 字节,长度最大 10 字节
font_colorstring按钮文案颜色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_bg_color_themestring按钮填充色,#000000-#FFFFFF,默认#07C160 字段长度为 7 字节
btn_border_color_themestring边框色,#000000-#FFFFFF,默认#FFFFFF 字段长度为 7 字节
btn_font_typeinteger按钮文案配置 取值 0: 常规, 1: 加粗. 默认 0 最小值 0,最大值 1
padding_topinteger上边距. 默认值 28 最小值 0,最大值 100
padding_bottominteger下边距. 默认值 28 最小值 0,最大值 100
use_iconinteger是否使用图标 取值 0: 不使用图标, 1: 使用图标. 默认 0 最小值 0,最大值 1
share_content_spec*struct分享信息,微信原生页分享信息
share_title*string分享标题 字段长度最小 1 字节,长度最大 42 字节
share_description*string分享描述 字段长度最小 1 字节,长度最大 60 字节

返回字段

名称类型描述
page_idint64页面 id
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1.3/wechat_pages_custom/add' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'page_specs_list=[
    {
        "page_elements_spec_list": [
            {
                "top_image_spec": [],
                "top_slider_spec": {
                    "image_id_list": []
                },
                "top_video_spec": [],
                "image_spec": [],
                "slider_spec": {
                    "image_id_list": []
                },
                "video_spec": [],
                "text_spec": [],
                "app_download_spec": {
                    "app_ios_spec": [],
                    "app_android_spec": []
                },
                "weapp_spec": [],
                "gh_spec": [],
                "enterprise_wx_spec": [],
                "image_text_spec": {
                    "image_text_item": [
                        {
                            "gh_spec": [],
                            "enterprise_wx_spec": []
                        }
                    ]
                }
            }
        ]
    }
]' \
--data-urlencode 'global_spec={
    "global_elements_spec_list": [
        {
            "float_button_spec": {
                "forbid_page_list": [],
                "app_download_spec": {
                    "app_ios_spec": [],
                    "app_android_spec": []
                },
                "weapp_spec": [],
                "gh_spec": [],
                "enterprise_wx_spec": []
            },
            "side_bar_float_spec": {
                "tel_spec": [],
                "wechat_service_spec": [],
                "enterprise_wx_spec": []
            }
        }
    ]
}' \
--data-urlencode 'share_content_spec=[]'
响应示例响应示例
{
    "code": 0,
    "message": "",
    "message_cn": ""
}

请求参数

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
默认值:
<TIMESTAMP>
nonce
string 
必需
以Query Parameter方式在请求路径中传递。 随机字串标识,不超过32个字符,由调用方自行生成,需保证全局唯一性。
默认值:
<NONCE>
Body 参数application/x-www-form-urlencoded
account_id
integer 
必需
推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id
示例值:
<ACCOUNT_ID>
page_specs_list
string 
必需
页面列表,页面顺序与生成的原生页的顺序一致
示例值:
[ { "page_elements_spec_list": [ { "top_image_spec": [], "top_slider_spec": { "image_id_list": [] }, "top_video_spec": [], "image_spec": [], "slider_spec": { "image_id_list": [] }, "video_spec": [], "text_spec": [], "app_download_spec": { "app_ios_spec": [], "app_android_spec": [] }, "weapp_spec": [], "gh_spec": [], "enterprise_wx_spec": [], "image_text_spec": { "image_text_item": [ { "gh_spec": [], "enterprise_wx_spec": [] } ] } } ] } ]
global_spec
string 
全局元素配置
必需
示例值:
{ "global_elements_spec_list": [ { "float_button_spec": { "forbid_page_list": [], "app_download_spec": { "app_ios_spec": [], "app_android_spec": [] }, "weapp_spec": [], "gh_spec": [], "enterprise_wx_spec": [] }, "side_bar_float_spec": { "tel_spec": [], "wechat_service_spec": [], "enterprise_wx_spec": [] } } ] }
share_content_spec
string 
必需
分享信息,微信原生页分享信息
示例值:
[]

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
message_cn
string 
必需
修改于 2023-11-02 07:38:22
上一页
基于模板创建微信原生页
下一页
获取微信落地页列表
Built with