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

alitrip.bp.ad.campaign.query (飞猪商业化计划详情查询)

飞猪商业化计划详情查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_request FAdCampaignQueryRequest 必须 查询参数
  • └ campaign_id
  • Number
  • 必须
  • 272372710
  • 计划id
  • └ biz_code
  • String
  • 必须
  • xx
  • 产品线code
  • └ business_id
  • String
  • 必须
  • xx
  • 业务调用id

响应参数

名称 类型 示例值 描述
result AdResult 业务调用结果
  • └ msg
  • String
  • 参数错误
  • 错误信息
  • └ trace_id
  • String
  • 2762hss2672ss2j2
  • 追溯id
  • └ rt
  • Number
  • 2
  • 调用时长
  • └ code
  • String
  • 错误code
  • 错误code
  • └ success
  • Boolean
  • true
  • 调用是否成功
  • model
  • 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
  • 827219bidPrice
  • 物料id
  • └ bid_price
  • Number
  • 120
  • 出价
  • └ cia_rate
  • Number
  • 30
  • 普通时段溢价比例
  • └ time_premium_max_rate
  • Number
  • 30
  • 特殊时段溢价
  • └ user_time_premium
  • String
  • 18:00-23:59
  • 溢价时段配置

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBpAdCampaignQueryRequest req = new AlitripBpAdCampaignQueryRequest();
AlitripBpAdCampaignQueryRequest.FAdCampaignQueryRequest obj1 = new AlitripBpAdCampaignQueryRequest.FAdCampaignQueryRequest();
obj1.setCampaignId(272372710L);
obj1.setBizCode("xx");
obj1.setBusinessId("xx");
req.setQueryRequest(obj1);
AlitripBpAdCampaignQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_bp_ad_campaign_query_response>
    <result>
        <msg>参数错误</msg>
        <trace_id>2762hss2672ss2j2</trace_id>
        <rt>2</rt>
        <code>错误code</code>
        <success>true</success>
        <model>
            <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>827219bidPrice</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>
        </model>
    </result>
</alitrip_bp_ad_campaign_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

返回
顶部