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

taobao.universalbp.new.bidword.findlist (词列表查询)

根据计划+单元id,查绑定的词列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
word_query_v_o WordQueryVO 必须 关键词查询
  • └ campaign_id_list
  • Number []
  • 可选
  • [68792788657]
  • 计划id集合,计划已经存在场景必填
  • └ adgroup_id_list
  • Number []
  • 可选
  • [68798447504]
  • 单元id集合,单元已经存在场景必填
  • rpt_query
  • RptQueryVO
  • 可选
  • 横向管理-实体数据列表-通用报表查询条件
  • 报表数据查询条件
  • └ fields
  • String
  • 可选
  • adPv,click,charge,ctr,ecpc,ecpm
  • 查询指标字段
  • condition_list
  • RptQueryConditionVO []
  • 可选
  • 报表查询条件
  • └ start_time
  • String
  • 可选
  • 2023-10-08
  • 开始时间
  • └ end_time
  • String
  • 可选
  • 2023-10-08
  • 结束时间
  • └ adzone_pkg_id_list
  • String []
  • 可选
  • ["114790550288", "114790550289", "114793500012", "114786650498"]
  • 流量来源(资源位包id)
  • └ is_rt
  • Boolean
  • 可选
  • true
  • 是否查询实时报表,true查实时、false查离线,不传则默认查离线
  • └ unify_type
  • String
  • 可选
  • zhai
  • 归因类型
  • └ source_list
  • String []
  • 可选
  • ["campaign_detail","adgroup_list"]
  • 来源,根据场景去选择,有的不需要传

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • word_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • word_v_o_list
  • WordVO []
  • 批量成功结果集
  • └ bidword_id
  • Number
  • 1131759830446
  • 关键词id
  • └ campaign_id
  • Number
  • 68796878069
  • 计划id,计划已经存在场景必填,eg:添加主体、编辑计划状态等场景
  • └ adgroup_id
  • Number
  • 68793666608
  • 单元id
  • └ word
  • String
  • 鞋原创小众
  • └ bid_price
  • String
  • 2.23
  • 关键词基础出价
  • └ status
  • String
  • launch
  • 状态,reject:排查拒绝,preview:排查中,launch:投放中,noflow:无展现
  • └ match_scope
  • Number
  • 4
  • 匹配类型,1:精准匹配,4:广泛匹配
  • bid_strategy_info
  • BidStrategyVO
  • 抢位信息
  • └ discount
  • Number
  • 30
  • 溢价
  • └ status
  • Number
  • 0
  • 0停止 ,1生效
  • └ rank
  • Number
  • 1
  • 抢位排名
  • └ rank_name
  • String
  • 首条
  • 排名名称
  • └ report_info_map
  • String
  • 报表数据

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewBidwordFindlistRequest req = new UniversalbpNewBidwordFindlistRequest();
UniversalbpNewBidwordFindlistRequest.TopServiceContext obj1 = new UniversalbpNewBidwordFindlistRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewBidwordFindlistRequest.WordQueryVO obj2 = new UniversalbpNewBidwordFindlistRequest.WordQueryVO();
obj2.setCampaignIdList(new Long[] { 68792788657 };
);
obj2.setAdgroupIdList(new Long[] { 68798447504 };
);
UniversalbpNewBidwordFindlistRequest.RptQueryVO obj3 = new UniversalbpNewBidwordFindlistRequest.RptQueryVO();
obj3.setFields("adPv,click,charge,ctr,ecpc,ecpm");
List<UniversalbpNewBidwordFindlistRequest.RptQueryConditionVO> list5 = new ArrayList<UniversalbpNewBidwordFindlistRequest.RptQueryConditionVO>();
UniversalbpNewBidwordFindlistRequest.RptQueryConditionVO obj6 = new UniversalbpNewBidwordFindlistRequest.RptQueryConditionVO();
list5.add(obj6);
obj6.setStartTime("2023-10-08");
obj6.setEndTime("2023-10-08");
obj6.setAdzonePkgIdList(""114790550288", "114790550289", "114793500012", "114786650498"");
obj6.setIsRt(true);
obj6.setUnifyType("zhai");
obj6.setSourceList(""campaign_detail","adgroup_list"");
obj3.setConditionList(list5);
obj2.setRptQuery(obj3);
req.setWordQueryVO(obj2);
UniversalbpNewBidwordFindlistResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_bidword_findlist_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <word_v_o_top_bulk_data>
            <count>10</count>
            <word_v_o_list>
                <word_v_o>
                    <bidword_id>1131759830446</bidword_id>
                    <campaign_id>68796878069</campaign_id>
                    <adgroup_id>68793666608</adgroup_id>
                    <word>鞋原创小众</word>
                    <bid_price>2.23</bid_price>
                    <status>launch</status>
                    <match_scope>4</match_scope>
                    <bid_strategy_info>
                        <discount>30</discount>
                        <status>0</status>
                        <rank>1</rank>
                        <rank_name>首条</rank_name>
                    </bid_strategy_info>
                </word_v_o>
            </word_v_o_list>
        </word_v_o_top_bulk_data>
    </top_result>
</universalbp_new_bidword_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

返回
顶部