获取落地页列表
全部接口

所属权限 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 个字符，由调用方自行生成，需保证全局唯一性

请求参数

标有*的参数为必填项

名称 类型 描述
account_id*
 integer 推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id
filtering
 struct[] 过滤条件，其中 page_type 筛选条件为必选字段
数组最小长度 1，最大长度 10
field*
 string 过滤字段
可选值：{ page_type, page_id, page_name, page_status, owner_account_id }
operator*
 enum 操作符，[枚举详情]
当 field 取值 page_type 时，可选值：{ EQUALS }
当 field 取值 page_id 时，可选值：{ EQUALS, IN }
当 field 取值 page_status 时，可选值：{ EQUALS, IN }
当 field 取值 page_name 时，可选值：{ EQUALS, CONTAINS }
当 field 取值 owner_account_id 时，可选值：{ EQUALS }
values*
 string[] 字段取值
当 field 取值 page_type 时，数组长度为 1
可选值：{ PAGE_TYPE_XJ_ANDROID_APP_H5, PAGE_TYPE_XJ_IOS_APP_H5, PAGE_TYPE_XJ_WEB_H5, PAGE_TYPE_FENGYE_ECOMMERCE, PAGE_TYPE_XJ_QUICK, PAGE_TYPE_OFFICIAL }
当 field 取值 page_id 且 operator 取值 IN 时，
数组最小长度 1，最大长度 100
当 field 取值 page_id 且 operator 取值 EQUALS 时，
数组长度为 1
当 field 取值 page_name 时，数组长度为 1
字段长度最小 1 字节，长度最大 180 字节
当 field 取值 page_status 且 operator 取值 IN 时，
数组最小长度 1，最大长度 3
可选值：{ NORMAL, DELETED, PENDING }
当 field 取值 page_status 且 operator 取值 EQUALS 时，
数组长度为 1
可选值：{ NORMAL, DELETED, PENDING }
当 field 取值 owner_account_id 时，数组长度为 1
page
 integer 搜索页码
最小值 1，最大值 99999
默认值：1
page_size
 integer 一页显示的数据条数
最小值 1，最大值 100
默认值：10
ad_context
 struct 广告上下文信息
marketing_goal*
 enum 营销目的类型，[枚举详情]
可选值：{ MARKETING_GOAL_UNKNOWN, MARKETING_GOAL_USER_GROWTH, MARKETING_GOAL_PRODUCT_SALES, MARKETING_GOAL_LEAD_RETENTION, MARKETING_GOAL_BRAND_PROMOTION, MARKETING_GOAL_INCREASE_FANS_INTERACTION }
marketing_sub_goal
 enum 二级营销目的类型，[枚举详情]
可选值：{ MARKETING_SUB_GOAL_UNKNOWN, MARKETING_SUB_GOAL_NEW_GAME_RESERVE, MARKETING_SUB_GOAL_NEW_GAME_TEST, MARKETING_SUB_GOAL_NEW_GAME_LAUNCH, MARKETING_SUB_GOAL_PLATEAU_PHASE_LAUNCH, MARKETING_SUB_GOAL_MINI_GAME_NEW_CUSTOMER_GROWTH, MARKETING_SUB_GOAL_MINI_GAME_RETURN_CUSTOMER_ENGAGEMENT, MARKETING_SUB_GOAL_APP_ACQUISITION, MARKETING_SUB_GOAL_APP_ACTIVATION, MARKETING_SUB_GOAL_NOT_INSTALL_USER, MARKETING_SUB_GOAL_PRE_INSTALL_USER, MARKETING_SUB_GOAL_UNLOADED_USER, MARKETING_SUB_GOAL_SHORT_INACTIVE_USER, MARKETING_SUB_GOAL_LONG_INACTIVE_USER }
marketing_carrier_type*
 enum 营销载体类型，[枚举详情]
可选值：{ MARKETING_CARRIER_TYPE_UNKNOWN, MARKETING_CARRIER_TYPE_APP_ANDROID, MARKETING_CARRIER_TYPE_APP_IOS, MARKETING_CARRIER_TYPE_WECHAT_OFFICIAL_ACCOUNT, MARKETING_CARRIER_TYPE_JUMP_PAGE, MARKETING_CARRIER_TYPE_WECHAT_MINI_GAME, MARKETING_CARRIER_TYPE_WECHAT_CHANNELS_LIVE, MARKETING_CARRIER_TYPE_WECHAT_CHANNELS, MARKETING_CARRIER_TYPE_WECHAT_CHANNELS_LIVE_RESERVATION, MARKETING_CARRIER_TYPE_MINI_PROGRAM_WECHAT, MARKETING_CARRIER_TYPE_APP_QUICK_APP, MARKETING_CARRIER_TYPE_PC_GAME, MARKETING_CARRIER_TYPE_QQ_MINI_GAME }
marketing_target_type*
 enum 推广产品类型，[枚举详情]
可选值：{ MARKETING_TARGET_TYPE_APP_ANDROID, MARKETING_TARGET_TYPE_APP_IOS, MARKETING_TARGET_TYPE_WECHAT_OFFICIAL_ACCOUNT, MARKETING_TARGET_TYPE_PRODUCT, MARKETING_TARGET_TYPE_TRAFFIC, MARKETING_TARGET_TYPE_LOCAL_STORE, MARKETING_TARGET_TYPE_WECHAT_MINI_GAME, MARKETING_TARGET_TYPE_CONSUMER_PRODUCT, MARKETING_TARGET_TYPE_WECHAT_CHANNELS, MARKETING_TARGET_TYPE_WECHAT_CHANNELS_LIVE, MARKETING_TARGET_TYPE_WECHAT_CHANNELS_LIVE_RESERVATION, MARKETING_TARGET_TYPE_MINI_PROGRAM_WECHAT, MARKETING_TARGET_TYPE_APP_QUICK_APP, MARKETING_TARGET_TYPE_CONSUME_MEDICAL, MARKETING_TARGET_TYPE_COMPREHENSIVE_HOUSEKEEPING, MARKETING_TARGET_TYPE_FICTION, MARKETING_TARGET_TYPE_SHORT_DRAMA, MARKETING_TARGET_TYPE_AUDIOVISUAL_ENTERTAINMENT, MARKETING_TARGET_TYPE_BEAUTY_AND_PERSONAL_CARE, MARKETING_TARGET_TYPE_WEDDING_AND_PORTRAIT_PHOTOGRAPHY, MARKETING_TARGET_TYPE_FRANCHISE_BRAND, MARKETING_TARGET_TYPE_ENTERPRISE_SERVICES, MARKETING_TARGET_TYPE_EXHIBITION_BOOTH_DESIGN, MARKETING_TARGET_TYPE_INSURANCE, MARKETING_TARGET_TYPE_BANK, MARKETING_TARGET_TYPE_CREDIT, MARKETING_TARGET_TYPE_INVESTMENT_CONSULTING, MARKETING_TARGET_TYPE_REAL_ESTATE, MARKETING_TARGET_TYPE_TELECOMMUNICATIONS_OPERATOR, MARKETING_TARGET_TYPE_TOURIST_ATTRACTIONS_TICKETS, MARKETING_TARGET_TYPE_RENOVATION_SERVICES, MARKETING_TARGET_TYPE_FURNITURE_AND_BUILDING_MATERIALS, MARKETING_TARGET_TYPE_EXHIBITION_SALES, MARKETING_TARGET_TYPE_MEDICINE_INDUSTRY_COMMERCIAL, MARKETING_TARGET_TYPE_FINANCE, MARKETING_TARGET_TYPE_LOCAL_STORE_PACKAGE, MARKETING_TARGET_TYPE_CATERING_AND_LEISURE, MARKETING_TARGET_TYPE_CHAIN_RESTAURANT, MARKETING_TARGET_TYPE_COMMODITY_SET, MARKETING_TARGET_TYPE_TOURIST_TRAVEL_ROUTE, MARKETING_TARGET_TYPE_TOURIST_CRUISE_LINE, MARKETING_TARGET_TYPE_TOURIST_HOTEL_SERVICE, MARKETING_TARGET_TYPE_TOURIST_AIRLINE_TICKETS, MARKETING_TARGET_TYPE_LOCAL_STORE_COMBINE_WITH_PRODUCT, MARKETING_TARGET_TYPE_ACTIVITY, MARKETING_TARGET_TYPE_STORE, MARKETING_TARGET_TYPE_MINI_GAME_QQ, MARKETING_TARGET_TYPE_PC_GAME, MARKETING_TARGET_TYPE_WECHAT_WORK, MARKETING_TARGET_TYPE_LIVE_STREAM_ROOM, MARKETING_TARGET_TYPE_PERSONAL_STORE, MARKETING_TARGET_TYPE_PLATFORM_CHANNEL, MARKETING_TARGET_TYPE_TWO_WHEEL_VEHICLE, MARKETING_TARGET_TYPE_GOVERNMENT_AFFAIRS, MARKETING_TARGET_TYPE_CAR_ECOLOGY }
marketing_carrier_detail
 struct 营销载体详情，当营销载体类型是 MARKETING_CARRIER_TYPE_APP_ANDROID、MARKETING_CARRIER_TYPE_APP_IOS 和 MARKETING_CARRIER_TYPE_WECHAT_MINI_GAME 等需要使用该结构体
marketing_carrier_id*
 string 营销载体 id，如安卓应用 id、IOS 应用 id、小游戏 id 等
字段长度最小 0 字节，长度最大 2048 字节
marketing_sub_carrier_id
 string 二级营销载体 id
marketing_carrier_name
 string 营销载体名称
marketing_asset_id
 integer 产品 id，marketing_asset_id 与 marketing_asset_outer_spec 不能同时为空，也不能同时使用
site_set*
 enum[] 投放站点集合，当前单站点或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO 的组合，[枚举详情]
数组最小长度 1，最大长度 32
可选值：{ SITE_SET_MOBILE_UNION, SITE_SET_WECHAT, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_MOBILE_YYB, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_CHANNELS, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN, SITE_SET_QBSEARCH, SITE_SET_SEARCH_SCENE }
creative_template_id*
 integer 创意规格 id，具体请咨询您的运营接口人，也可通过 [ [创意规格查询工具] ] 进行查询
promoted_asset_type
 enum 推广类容类型，[枚举详情]
可选值：{ PROMOTED_ASSET_TYPE_APP_ANDROID, PROMOTED_ASSET_TYPE_APP_IOS, PROMOTED_ASSET_TYPE_WECHAT_OFFICIAL_ACCOUNT, PROMOTED_ASSET_TYPE_EDUCATION, PROMOTED_ASSET_TYPE_TRAFFIC, PROMOTED_ASSET_TYPE_LOCAL_STORE, PROMOTED_ASSET_TYPE_MINIGAME, PROMOTED_ASSET_TYPE_CONSUMER_PRODUCT, PROMOTED_ASSET_TYPE_WECHAT_CHANNELS, PROMOTED_ASSET_TYPE_WECHAT_CHANNELS_LIVE, PROMOTED_ASSET_TYPE_WECHAT_CHANNELS_LIVE_RESERVATION, PROMOTED_ASSET_TYPE_MINI_PROGRAM_WECHAT, PROMOTED_ASSET_TYPE_APP_QUICK_APP, PROMOTED_ASSET_TYPE_CONSUME_MEDICAL, PROMOTED_ASSET_TYPE_COMPREHENSIVE_HOUSEKEEPING, PROMOTED_ASSET_TYPE_FICTION, PROMOTED_ASSET_TYPE_SHORT_DRAMA, PROMOTED_ASSET_TYPE_AUDIOVISUAL_ENTERTAINMENT, PROMOTED_ASSET_TYPE_BEAUTY_AND_PERSONAL_CARE, PROMOTED_ASSET_TYPE_WEDDING_AND_PORTRAIT_PHOTOGRAPHY, PROMOTED_ASSET_TYPE_FRANCHISE_BRAND, PROMOTED_ASSET_TYPE_ENTERPRISE_SERVICES, PROMOTED_ASSET_TYPE_EXHIBITION_BOOTH_DESIGN, PROMOTED_ASSET_TYPE_INSURANCE, PROMOTED_ASSET_TYPE_BANK, PROMOTED_ASSET_TYPE_CREDIT, PROMOTED_ASSET_TYPE_INVESTMENT_CONSULTING, PROMOTED_ASSET_TYPE_REAL_ESTATE, PROMOTED_ASSET_TYPE_TELECOMMUNICATIONS_OPERATOR, PROMOTED_ASSET_TYPE_TOURIST_ATTRACTIONS_TICKETS, PROMOTED_ASSET_TYPE_RENOVATION_SERVICES, PROMOTED_ASSET_TYPE_FURNITURE_AND_BUILDING_MATERIALS, PROMOTED_ASSET_TYPE_EXHIBITION_SALES, PROMOTED_ASSET_TYPE_MEDICINE_INDUSTRY_COMMERCIAL, PROMOTED_ASSET_TYPE_FINANCE, PROMOTED_ASSET_TYPE_LOCAL_STORE_PACKAGE, PROMOTED_ASSET_TYPE_CATERING_AND_LEISURE, PROMOTED_ASSET_TYPE_CHAIN_RESTAURANT, PROMOTED_ASSET_TYPE_COMMODITY_SET, PROMOTED_ASSET_TYPE_TOURIST_TRAVEL_ROUTE, PROMOTED_ASSET_TYPE_TOURIST_CRUISE_LINE, PROMOTED_ASSET_TYPE_TOURIST_HOTEL_SERVICE, PROMOTED_ASSET_TYPE_TOURIST_AIRLINE_TICKETS, PROMOTED_ASSET_TYPE_LOCAL_STORE_COMBINE_WITH_PRODUCT, PROMOTED_ASSET_TYPE_ACTIVITY, PROMOTED_ASSET_TYPE_STORE, PROMOTED_ASSET_TYPE_MINI_GAME_QQ, PROMOTED_ASSET_TYPE_PC_GAME, PROMOTED_ASSET_TYPE_WECHAT_WORK, PROMOTED_ASSET_TYPE_LIVE_STREAM_ROOM, PROMOTED_ASSET_TYPE_PERSONAL_STORE, PROMOTED_ASSET_TYPE_PLATFORM_CHANNEL, PROMOTED_ASSET_TYPE_TWO_WHEEL_VEHICLE, PROMOTED_ASSET_TYPE_GOVERNMENT_AFFAIRS, PROMOTED_ASSET_TYPE_CAR_ECOLOGY }

请求示例


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

应答字段

名称 类型 描述
list
 struct[] 返回信息列表
page_type
 enum 落地页类型，[枚举详情]
page_id
 int64 落地页 id
page_name
 string 落地页名称
page_url
 string 落地页 url
page_status
 enum 落地页状态，[枚举详情]
owner_account_id
 integer 推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id
created_time
 integer 创建时间
last_modified_time
 integer 最后修改时间
disable_code
 integer 不可用错误码
disable_message
 string 不可用错误信息
page_info
 struct 分页配置信息
page
 integer 搜索页码
默认值：1
page_size
 integer 一页显示的数据条数
默认值：10
total_number
 integer 总条数
total_page
 integer 总页数

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "page_type": "PAGE_TYPE_OFFICIAL",
                "page_id": 12345,
                "page_name": "官方落地页-示例",
                "page_url": "https://h5.gdt.qq.com/xjviewer/nemo/12345",
                "page_status": "NORMAL",
                "created_time": 1704038400,
                "last_modified_time": 1704038400
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

可视化调试工具

广告资源

广告技术

开发文档

辅助工具

帮助支持

手机浏览开发者官网

Copyright © 1998 - Tencent Inc. All Rights Reserved.