落地页 (Page)

V1.1

loading

本节将为您介绍落地页 (Page)相关接口。通过落地页相关接口，您可以获取您通过落地页制作工具制作的落地页信息, 通过本接口不会返回审核拒绝的落地页内容。更详细的介绍可以参考【落地页】章节。

所属权限（scope）：Ads Management

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

所属权限	Ads Management
请求地址	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
promoted_object_type	enum	推广目标类型，[枚举详情] 枚举列表：{ PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_QZONE_VIDEO_PAGE, PROMOTED_OBJECT_TYPE_ARTICLE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_TENCENT_KE, PROMOTED_OBJECT_TYPE_QZONE_PAGE_ARTICLE, PROMOTED_OBJECT_TYPE_QZONE_PAGE_IFRAMED, PROMOTED_OBJECT_TYPE_QZONE_PAGE, PROMOTED_OBJECT_TYPE_APP_PC, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_MINI_GAME_QQ, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT, PROMOTED_OBJECT_TYPE_APP_QUICK_APP, PROMOTED_OBJECT_TYPE_WECHAT_ARTICLE, PROMOTED_OBJECT_TYPE_WECHAT_PAY_COUPON }
filtering	struct[]	过滤条件，若此字段不传，或传空则视为无限制条件数组最小长度 1，最大长度 10
field*	string	过滤字段可选值：{ page_id, promoted_object_id, product_catalog_id, page_type, platform, page_name, page_status, last_modified_time, fengye_sub_type, owner_uid, site_set, product_source, buying_type, adcreative_template_id, live_notice_id, finder_username, live_video_mode, live_video_sub_mode }
operator*	enum	操作符当 field 取值 page_id 时，枚举列表：{ EQUALS, IN } 当 field 取值 promoted_object_id 时，枚举列表：{ EQUALS } 当 field 取值 product_catalog_id 时，枚举列表：{ EQUALS } 当 field 取值 last_modified_time 时，枚举列表：{ GREATER_EQUALS, GREATER_EQUALS } 当 field 取值 page_type 时，枚举列表：{ EQUALS } 当 field 取值 platform 时，枚举列表：{ EQUALS } 当 field 取值 page_name 时，枚举列表：{ EQUALS, CONTAINS } 当 field 取值 page_status 时，枚举列表：{ IN } 当 field 取值 fengye_sub_type 时，枚举列表：{ IN } 当 field 取值 owner_uid 时，枚举列表：{ EQUALS } 当 field 取值 site_set 时，枚举列表：{ IN } 当 field 取值 product_source 时，枚举列表：{ EQUALS } 当 field 取值 buying_type 时，枚举列表：{ EQUALS } 当 field 取值 adcreative_template_id 时，枚举列表：{ EQUALS } 当 field 取值 live_notice_id 时，枚举列表：{ EQUALS } 当 field 取值 finder_username 时，枚举列表：{ EQUALS } 当 field 取值 live_video_mode 时，枚举列表：{ EQUALS } 当 field 取值 live_video_sub_mode 时，枚举列表：{ EQUALS }
values*	string[]	字段取值当 field 取值 promoted_object_id 时，字段长度最小 0 字节，长度最大 128 字节当 field 取值 page_type 时，枚举列表：{ PAGE_TYPE_YUEBAO_QUICKAPP, PAGE_TYPE_YUEBAO_OFFICIAL_ACCOUNT_ARTICLE, PAGE_TYPE_XIJING_QUICK, PAGE_TYPE_LINGQUE_H5, PAGE_TYPE_LINGQUE_MINI_PROGRAM, PAGE_TYPE_WECHAT_CHANNELS_SHOP_PRODUCT, PAGE_TYPE_WECHAT_QUERY_PAGE } 当 field 取值 platform 时，枚举列表：{ LANDING_PAGE_PLATFORM_UNKNOWN, LANDING_PAGE_PLATFORM_TSA, LANDING_PAGE_PLATFORM_FENGYE_EC, LANDING_PAGE_PLATFORM_FENGYE_DEFAULT, LANDING_PAGE_PLATFORM_XIJING, LANDING_PAGE_PLATFORM_YOUZAN, LANDING_PAGE_PLATFORM_MP, LANDING_PAGE_PLATFORM_APP_STORE, LANDING_PAGE_PLATFORM_YIYE, LANDING_PAGE_PLATFORM_JINSHUJU, LANDING_PAGE_PLATFORM_WEIMOB, LANDING_PAGE_PLATFORM_QQ_MOBILE, LANDING_PAGE_PLATFORM_QQ_BROWSER, LANDING_PAGE_PLATFORM_PLAY, LANDING_PAGE_PLATFORM_YUEBAO, LANDING_PAGE_PLATFORM_HEBANG, LANDING_PAGE_PLATFORM_HELIANG, LANDING_PAGE_PLATFORM_MADAO, LANDING_PAGE_PLATFORM_ZHONGZHI, LANDING_PAGE_PLATFORM_LINGQUE } 当 field 取值 page_status 时，枚举列表：{ NORMAL, DELETED, PENDING } 当 field 取值 fengye_sub_type 时，枚举列表：{ FENGYE_DIRECT, FENGYE_SHOP } 当 field 取值 site_set 时，枚举列表：{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_MYAPP, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_KUAISHOU, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_MOBILE_YYB, SITE_SET_QQSHOPPING, SITE_SET_CHANNELS, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN, SITE_SET_FREETRADE, SITE_SET_QBSEARCH, SITE_SET_FREETRADE_FINDER, SITE_SET_BROWSER_MOBILE, SITE_SET_SEARCH_SCENE, SITE_SET_BROWSER_PC, SITE_SET_CHANNELS_CONTENT_PROMOTION, SITE_SET_FREETRADE_WEAPP, SITE_SET_FREETRADE_QQ, SITE_SET_YUNXUAN }
page	integer	搜索页码，默认值：1 最小值 1，最大值 99999
page_size	integer	一页显示的数据条数，默认值：10 最小值 1，最大值 100

使用说明

非电商落地页的预览过期时间为一小时。
当且仅当推广目标为 PROMOTED_OBJECT_TYPE_APP_ANDROID 或 PROMOTED_OBJECT_TYPE_APP_IOS 时，才可选择根据 promoted_object_id 进行过滤(未传入 page_type 过滤时默认 page_type=PAGE_TYPE_TSA_APP)。
当且仅当推广目标为 PROMOTED_OBJECT_TYPE_ECOMMERCE 时，才可选择根据 promoted_object_id 和 product_catalog_id 进行过滤。
当传入 page_type 参数时，promoted_object_type 参数仅用于标识 promoted_object_id 类型
。

请求示例


curl -G 'https://api.e.qq.com/v1.1/pages/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[]' \
-d 'page=1' \
-d 'page_size=10'

应答字段

名称	类型	描述
list	struct[]	返回信息列表
page_id	int64	落地页 id
page_name	string	落地页名称
preview_url	string	预览地址
created_time	integer	创建时间戳（Unix 时间戳，单位为秒）
last_modified_time	integer	最后修改时间戳（Unix 时间戳，单位为秒）
promoted_object_id	string	推广目标 id，详见 [推广目标类型]，仅当以 promoted_object_id 为过滤字段时返回
product_catalog_id	integer	商品库 id，仅当以 product_catalog_id 为过滤字段时返回
page_type	enum	落地页类型，[枚举详情]
playable_type	enum	蹊径落地页试玩类型，[枚举详情]
page_status	enum	状态，状态定义，[枚举详情]
fengye_sub_type	enum	枫页落地页子类型，[枚举详情]
owner_uid	integer	授权方 uid
quote_creative_material	boolean	落地页顶部组件是否引用创意素材图片或视频,目前仅在蹊径性能版落地页上有效
disable_code	integer	落地页不可用错误码
disable_message	string	落地页不可用错误原因
page_info	struct	分页配置信息
page	integer	搜索页码
page_size	integer	一页显示的数据条数
total_number	integer	总条数
total_page	integer	总页数

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "page_id": 1,
                "page_name": "营销组件-商品购物页-20181109",
                "created_time": 1491019858,
                "last_modified_time": 1491098468
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

可视化调试工具

问题仍未解决？

请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务

首页

开发文档

最新动态

腾讯广告

落地页 (Page)

V1.1

loading

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

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

首页

开发文档

最新动态

腾讯广告

落地页 (Page) V1.1 loading

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

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

落地页 (Page)

V1.1

loading

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