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

taobao.universalbp.new.bidword.update (批量修改关键词)

向已经存在的单元中,批量修改关键词,包括状态、出价

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
word_update_request_v_o WordUpdateRequestVO 必须 wordUpdateRequestVO
  • bidword_list
  • WordCommandVO []
  • 可选
  • 关键词集合
  • └ bidword_id
  • Number
  • 可选
  • 1124844766581
  • 关键词id,关键词已经存在场景必填
  • └ campaign_id
  • Number
  • 可选
  • 68796878069
  • 计划id,计划已经存在场景必填
  • └ adgroup_id
  • Number
  • 可选
  • 68793666608
  • 单元id,单元已经存在场景必填
  • └ word
  • String
  • 可选
  • 鞋原创小众
  • └ bid_price
  • String
  • 可选
  • 2.23
  • 关键词基础出价
  • └ online_status
  • Number
  • 可选
  • 1
  • 词包状态,1:在线,0:下线
  • └ match_scope
  • Number
  • 可选
  • 4
  • 匹配类型,1:精准匹配,4:广泛匹配
  • bid_strategy_info
  • BidStrategyVO
  • 可选
  • 抢位信息
  • └ discount
  • Number
  • 可选
  • 30
  • 溢价
  • └ status
  • Number
  • 可选
  • 0
  • 0-停止,1-生效
  • └ rank
  • Number
  • 可选
  • 1
  • 抢位排名
  • └ rank_name
  • String
  • 可选
  • 首条
  • 排名名称

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • word_command_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • word_command_v_o_list
  • WordCommandVO []
  • 批量成功结果集
  • └ bidword_id
  • Number
  • 1124844766581
  • 关键词id,关键词已经存在场景必填
  • └ campaign_id
  • Number
  • 68796878069
  • 计划id,计划已经存在场景必填
  • └ adgroup_id
  • Number
  • 68793666608
  • 单元id,单元已经存在场景必填
  • └ word
  • String
  • 鞋原创小众
  • └ bid_price
  • String
  • 2.23
  • 关键词基础出价
  • └ online_status
  • Number
  • 1
  • 词包状态,1:在线,0:下线
  • └ match_scope
  • Number
  • 4
  • 匹配类型,1:精准匹配,4:广泛匹配

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewBidwordUpdateRequest req = new UniversalbpNewBidwordUpdateRequest();
UniversalbpNewBidwordUpdateRequest.TopServiceContext obj1 = new UniversalbpNewBidwordUpdateRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewBidwordUpdateRequest.WordUpdateRequestVO obj2 = new UniversalbpNewBidwordUpdateRequest.WordUpdateRequestVO();
List<UniversalbpNewBidwordUpdateRequest.WordCommandVO> list4 = new ArrayList<UniversalbpNewBidwordUpdateRequest.WordCommandVO>();
UniversalbpNewBidwordUpdateRequest.WordCommandVO obj5 = new UniversalbpNewBidwordUpdateRequest.WordCommandVO();
list4.add(obj5);
obj5.setBidwordId(1124844766581L);
obj5.setCampaignId(68796878069L);
obj5.setAdgroupId(68793666608L);
obj5.setWord("鞋原创小众");
obj5.setBidPrice("2.23");
obj5.setOnlineStatus(1L);
obj5.setMatchScope(4L);
UniversalbpNewBidwordUpdateRequest.BidStrategyVO obj7 = new UniversalbpNewBidwordUpdateRequest.BidStrategyVO();
obj7.setDiscount(30L);
obj7.setStatus(0L);
obj7.setRank(1L);
obj7.setRankName("首条");
list6.setBidStrategyInfo(obj7);
obj2.setBidwordList(list4);
req.setWordUpdateRequestVO(obj2);
UniversalbpNewBidwordUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_bidword_update_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <word_command_v_o_top_bulk_data>
            <count>10</count>
            <word_command_v_o_list>
                <word_command_v_o>
                    <bidword_id>1124844766581</bidword_id>
                    <campaign_id>68796878069</campaign_id>
                    <adgroup_id>68793666608</adgroup_id>
                    <word>鞋原创小众</word>
                    <bid_price>2.23</bid_price>
                    <online_status>1</online_status>
                    <match_scope>4</match_scope>
                </word_command_v_o>
            </word_command_v_o_list>
        </word_command_v_o_top_bulk_data>
    </top_result>
</universalbp_new_bidword_update_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

返回
顶部