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

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

所属权限 Ads Management
请求地址 xijing_page_list/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
page_id
integer 落地页 id,由蹊径生成的 id,主要用于在蹊径内查询落地页
page_service_id
string 落地页服务 id,主要用于广告投放、落地页送审及删除
字段长度最小 0 字节,长度最大 256 字节
page_name
string 落地页名称-用于管理
字段长度为 20 字节
page_type
enum 蹊径落地页类型,[枚举详情]
枚举列表:{ XJ_DEFAULT_H5, XJ_ANDROID_APP_H5, XJ_IOS_APP_H5, XJ_WEBSITE_H5, XJ_ANDROID_APP_NATIVE, XJ_IOS_APP_NATIVE, XJ_WEBSITE_NATIVE, XJ_FENGLING_LBS }
page_last_modify_start_time
string 蹊径落地页最近更新时间
字段长度最小 0 字节,长度最大 30 字节
page_last_modify_end_time
string 蹊径落地页最近更新时间
字段长度最小 0 字节,长度最大 30 字节
page_size
integer 数据页面大小
page_index
integer 数据页数
page_publish_status
enum 蹊径落地页发布状态,[枚举详情]
枚举列表:{ LANDING_PAGE_STATUS_UNPUBLISH, LANDING_PAGE_STATUS_PUBLISHED, LANDING_PAGE_STATUS_OFFLINE, LANDING_PAGE_STATUS_DELETING, LANDING_PAGE_STATUS_DELETED }
page_status
enum 蹊径落地页状态,[枚举详情]
枚举列表:{ LANDING_PAGE_STATUS_EDITING, LANDING_PAGE_STATUS_PENDING, LANDING_PAGE_STATUS_APPROVED, LANDING_PAGE_STATUS_REJECTED, LANDING_PAGE_STATUS_DELETED }

请求示例


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

应答字段

名称 类型 描述
list
struct[] 蹊径落地页返回数据结构
page_id
integer 落地页 id,由蹊径生成的 id,主要用于在蹊径内查询落地页
page_service_id
string 落地页服务 id,主要用于广告投放、落地页送审及删除
page_name
string 落地页名称-用于管理
page_type
enum 蹊径落地页类型,[枚举详情]
page_publish_status
enum 蹊径落地页发布状态,[枚举详情]
page_status
enum 蹊径落地页状态,[枚举详情]
page_last_modify_time
string 蹊径落地页最近更新时间
total_pages
integer 落地页总数
page_size
integer 数据页面大小
page_index
integer 数据页数

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "page_id": 523034383985764607,
                "page_service_id": 523034383985764607,
                "page_type": "XJ_ANDROID_APP_H5",
                "page_name": "落地页-名称",
                "page_publish_status": "LANDING_PAGE_STATUS_PUBLISHED",
                "page_status": "LANDING_PAGE_STATUS_EDITING",
                "page_last_modify_time": "2020-07-30 20:45:19"
            }
        ],
        "total_pages": 324,
        "page_size": 10,
        "page_index": 1
    }
}

可视化调试工具