文档中心 > API类目 > 万相台无界API

taobao.universalbp.new.adzone.aggregated.findlist (横向管理查看资源包列表)

横向管理查看资源包列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
adzone_ref_query_v_o AdzoneRefQueryVO 必须 adzoneRefQueryVO
  • └ campaign_id_list
  • Number []
  • 必须
  • [68792788657]
  • 计划id集合
  • └ offset
  • Number
  • 可选
  • 10
  • 偏移量
  • └ page_size
  • Number
  • 可选
  • 10
  • 页面大小

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • adzone_ref_aggregated_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • adzone_ref_aggregated_v_o_list
  • AdzoneRefAggregatedVO []
  • 批量成功结果集
  • └ campaign_id
  • Number
  • 68796878069
  • 计划id
  • adzone_list
  • AdzoneRefVO []
  • 资源包关联关系
  • └ adzone_id
  • Number
  • 111287850198
  • 资源包id
  • └ adzone_name
  • String
  • 全屏微详情
  • 资源包名字
  • └ min_discount
  • Number
  • 1
  • 资源位支持的最低溢价
  • └ max_discount
  • Number
  • 30
  • 资源位支持的最高溢价
  • └ campaign_id
  • Number
  • 68796878069
  • 计划id,计划已经存在场景必填,eg:添加主体、编辑计划状态等场景
  • └ campaign_name
  • String
  • 管家计划_宝贝候选集
  • 计划名称
  • └ bid_type
  • String
  • max_amount
  • 出价方式,custom_bid:手动出价,max_amount:最大化拿量,cost_control:控成本,roi_control:控投产比
  • └ discount
  • Number
  • 0
  • 资源位/包 溢价
  • └ fit_discount
  • Number
  • 0
  • 建议溢价
  • └ status
  • String
  • start
  • 状态,start:投放,pause:暂停
  • operation_list
  • OperationVO []
  • 操作按钮列表
  • └ code
  • String
  • 12
  • 操作项code
  • └ name
  • String
  • 操作
  • 操作项名称
  • └ tips
  • String
  • xxxx
  • 悬浮提示
  • └ disabled
  • Boolean
  • false
  • 是否可操作
  • └ properties
  • String
  • 扩展属性

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewAdzoneAggregatedFindlistRequest req = new UniversalbpNewAdzoneAggregatedFindlistRequest();
UniversalbpNewAdzoneAggregatedFindlistRequest.TopServiceContext obj1 = new UniversalbpNewAdzoneAggregatedFindlistRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewAdzoneAggregatedFindlistRequest.AdzoneRefQueryVO obj2 = new UniversalbpNewAdzoneAggregatedFindlistRequest.AdzoneRefQueryVO();
obj2.setCampaignIdList(new Long[] { 68792788657 };
);
obj2.setOffset(10L);
obj2.setPageSize(10L);
req.setAdzoneRefQueryVO(obj2);
UniversalbpNewAdzoneAggregatedFindlistResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_adzone_aggregated_findlist_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <adzone_ref_aggregated_v_o_top_bulk_data>
            <count>10</count>
            <adzone_ref_aggregated_v_o_list>
                <adzone_ref_aggregated_v_o>
                    <campaign_id>68796878069</campaign_id>
                    <adzone_list>
                        <adzone_ref_v_o>
                            <adzone_id>111287850198</adzone_id>
                            <adzone_name>全屏微详情</adzone_name>
                            <min_discount>1</min_discount>
                            <max_discount>30</max_discount>
                            <campaign_id>68796878069</campaign_id>
                            <campaign_name>管家计划_宝贝候选集</campaign_name>
                            <bid_type>max_amount</bid_type>
                            <discount>0</discount>
                            <fit_discount>0</fit_discount>
                            <status>start</status>
                            <operation_list>
                                <operation_v_o>
                                    <code>12</code>
                                    <name>操作</name>
                                    <tips>xxxx</tips>
                                    <disabled>false</disabled>
                                </operation_v_o>
                            </operation_list>
                        </adzone_ref_v_o>
                    </adzone_list>
                </adzone_ref_aggregated_v_o>
            </adzone_ref_aggregated_v_o_list>
        </adzone_ref_aggregated_v_o_top_bulk_data>
    </top_result>
</universalbp_new_adzone_aggregated_findlist_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

返回
顶部