文档中心 > API类目 > 飞猪商业化API

alitrip.bp.ad.campaign.page.query (计划分页查询)

计划分页查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
campaign_page_query_request FAdCampaignPageQueryRequest 必须 分页请求参数
  • └ page_no
  • Number
  • 必须
  • 1
  • 页数,从1开始
  • └ biz_code
  • String
  • 必须
  • fliggySearch
  • 业务线code
  • └ business_id
  • String
  • 必须
  • xx
  • 调用方
  • └ page_size
  • Number
  • 必须
  • 10
  • 每页计划数量
  • └ include_ad_group
  • Boolean
  • 必须
  • false
  • 是否需要获取单元信息
  • └ begin_time
  • String
  • 可选
  • 20260101
  • 计划开始时间
  • └ end_time
  • String
  • 可选
  • 20260102
  • 计划结束时间
  • └ status
  • Number
  • 必须
  • 0
  • 计划状态(0:全部状态,1:推广中,2:暂停,3:已结束,4:未开始,5:已删除)

响应参数

名称 类型 示例值 描述
result AdResult 业务调用结果
  • └ msg
  • String
  • 参数错误
  • 错误信息
  • └ trace_id
  • String
  • 2762hss2672ss2j2
  • 追溯id
  • └ rt
  • Number
  • 2
  • 调用时长
  • └ code
  • String
  • 错误code
  • 错误code
  • └ success
  • Boolean
  • true
  • 调用是否成功
  • model
  • FAdCampaignPageDTO
  • 分页调用结果
  • campaign_list
  • FAdCampaignDTO []
  • 计划列表
  • └ campaign_id
  • Number
  • 2720233
  • 计划id
  • └ member_id
  • Number
  • 228222
  • 广告主id
  • └ begin_time
  • String
  • 20251101
  • 开始时间
  • └ end_time
  • String
  • 20251102
  • 结束时间
  • └ status
  • Number
  • 1
  • 计划状态(0:暂停,1:推广中,101:未开始,9:已结束,102:已删除)
  • └ budget_type
  • String
  • 1
  • 预算类型
  • └ day_budget
  • Number
  • 10000
  • 日预算
  • └ total_budget
  • Number
  • 500000
  • 总预算
  • └ month_budget
  • String
  • 202508:500000;202509:600000
  • 月度预算
  • └ pacing_type
  • Number
  • 1
  • 消耗模式
  • ad_group_list
  • FAdGroupDTO []
  • 单元物料信息
  • └ ad_group_id
  • Number
  • 2828
  • 单元id
  • └ material_id
  • Number
  • 827219
  • 物料id
  • └ bid_price
  • Number
  • 120
  • 出价
  • └ cia_rate
  • Number
  • 30
  • 普通时段溢价比例
  • └ time_premium_max_rate
  • Number
  • 30
  • 特殊时段溢价
  • └ user_time_premium
  • String
  • 18:00-23:59
  • 溢价时段配置
  • └ page_no
  • Number
  • 1
  • 当前页数
  • └ page_size
  • Number
  • 10
  • 当前页计划数
  • └ total_count
  • Number
  • 100
  • 总计划数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBpAdCampaignPageQueryRequest req = new AlitripBpAdCampaignPageQueryRequest();
AlitripBpAdCampaignPageQueryRequest.FAdCampaignPageQueryRequest obj1 = new AlitripBpAdCampaignPageQueryRequest.FAdCampaignPageQueryRequest();
obj1.setPageNo(1L);
obj1.setBizCode("fliggySearch");
obj1.setBusinessId("xx");
obj1.setPageSize(10L);
obj1.setIncludeAdGroup(false);
obj1.setBeginTime("20260101");
obj1.setEndTime("20260102");
obj1.setStatus(0L);
req.setCampaignPageQueryRequest(obj1);
AlitripBpAdCampaignPageQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_bp_ad_campaign_page_query_response>
    <result>
        <msg>参数错误</msg>
        <trace_id>2762hss2672ss2j2</trace_id>
        <rt>2</rt>
        <code>错误code</code>
        <success>true</success>
        <model>
            <campaign_list>
                <f_ad_campaign_d_t_o>
                    <campaign_id>2720233</campaign_id>
                    <member_id>228222</member_id>
                    <begin_time>20251101</begin_time>
                    <end_time>20251102</end_time>
                    <status>1</status>
                    <budget_type>1</budget_type>
                    <day_budget>10000</day_budget>
                    <total_budget>500000</total_budget>
                    <month_budget>202508:500000;202509:600000</month_budget>
                    <pacing_type>1</pacing_type>
                    <ad_group_list>
                        <f_ad_group_d_t_o>
                            <ad_group_id>2828</ad_group_id>
                            <material_id>827219</material_id>
                            <bid_price>120</bid_price>
                            <cia_rate>30</cia_rate>
                            <time_premium_max_rate>30</time_premium_max_rate>
                            <user_time_premium>18:00-23:59</user_time_premium>
                        </f_ad_group_d_t_o>
                    </ad_group_list>
                </f_ad_campaign_d_t_o>
            </campaign_list>
            <page_no>1</page_no>
            <page_size>10</page_size>
            <total_count>100</total_count>
        </model>
    </result>
</alitrip_bp_ad_campaign_page_query_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部