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

alitrip.bp.ad.group.query (飞猪商业化bp单元查询)

飞猪商业化bp单元查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_request FAdGroupQueryRequest 必须 单元查询
  • └ biz_code
  • String
  • 必须
  • xx
  • 产品线code
  • └ business_id
  • String
  • 必须
  • xx
  • 业务调用方id
  • └ ad_group_id
  • Number
  • 必须
  • 121233
  • 单元id

响应参数

名称 类型 示例值 描述
result AdResult 返回结果
  • └ msg
  • String
  • 参数错误
  • 错误信息
  • └ trace_id
  • String
  • 28227sdfas
  • 追溯id
  • └ rt
  • Number
  • 2
  • 查询耗时
  • └ code
  • String
  • -190
  • 错误code
  • └ success
  • Boolean
  • true
  • 是否成功
  • model
  • FAdGroupDTO
  • 单元具体信息
  • └ material_id
  • Number
  • 223323
  • 物料id
  • └ bid_price
  • Number
  • 120
  • 出价
  • └ cia_rate
  • Number
  • 30
  • 溢价比例
  • └ time_premium_max_rate
  • Number
  • 30
  • 特殊时段溢价比例
  • └ user_time_premium
  • String
  • 18:00-23:59
  • 溢价时段配置
  • └ ad_group_id
  • Number
  • 112445
  • 单元id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBpAdGroupQueryRequest req = new AlitripBpAdGroupQueryRequest();
AlitripBpAdGroupQueryRequest.FAdGroupQueryRequest obj1 = new AlitripBpAdGroupQueryRequest.FAdGroupQueryRequest();
obj1.setBizCode("xx");
obj1.setBusinessId("xx");
obj1.setAdGroupId(121233L);
req.setQueryRequest(obj1);
AlitripBpAdGroupQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_bp_ad_group_query_response>
    <result>
        <msg>参数错误</msg>
        <trace_id>28227sdfas</trace_id>
        <rt>2</rt>
        <code>-190</code>
        <success>true</success>
        <model>
            <material_id>223323</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>
            <ad_group_id>112445</ad_group_id>
        </model>
    </result>
</alitrip_bp_ad_group_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

返回
顶部