文档中心 > API类目 > 直通车API

taobao.universalbp.wordpackage.suggestkrlist (关键词包建议)

入参推广信息,出参建议的全部关键词包

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
word_package_suggest_query_v_o WordPackageSuggestQueryVo 必须 wordPackageSuggestQueryVO
  • └ material_id
  • Number
  • 可选
  • 715017855321
  • 宝贝id
  • └ type
  • String
  • 可选
  • trendTheme
  • 类型,overall:综合推荐,trendtheme:趋势词包,automatch:流量智选,extend:流量扩展,highquality:优质卖点词包推荐(用于卖点词包报告),new_default:新建流程默认推荐词包;
  • └ campaign_id
  • Number
  • 可选
  • 68792485515
  • 计划id
  • └ adgroup_id
  • Number
  • 可选
  • 68792986520
  • 单元id

响应参数

名称 类型 示例值 描述
result TopResult 结果体
  • info
  • TopInfo
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • suggest_word_package_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • suggest_word_package_v_o_list
  • SuggestWordPackageVo []
  • 批量结果集
  • └ word_package_id
  • Number
  • 191014
  • 词包id
  • └ word_package_type
  • Number
  • 20
  • 词包类型,0:流量智选,20:卖点词包
  • └ word_package_name
  • String
  • 碎花
  • 词包名称
  • └ bid_price
  • String
  • 1
  • 建议出价
  • └ impression
  • String
  • 10-20
  • 预估展现
  • └ multi_factor
  • String
  • 10.0
  • 流量放大系数
  • └ theme_word_list
  • String []
  • ["碎花"]
  • 主题词
  • └ simple_word_list
  • String []
  • ["碎花裙", "碎花连衣裙", "碎花连衣裙女", "法式碎花裙"]
  • 关键词举例
  • └ relevance_type
  • Number
  • 3
  • 相关性,1:差,2:中,3:好
  • strategy_list
  • WordPackageStrategyVo []
  • 流量智选选词策略
  • └ strategy_id
  • Number
  • 2
  • 词包策略,0:流量智选,1:好词优选,2:捡漏,2:卖点词包,3:类目优选
  • └ strategy_name
  • String
  • 好词优选
  • 词包策略名称
  • └ bid_price
  • String
  • 2.23
  • 关键词基础出价
  • └ online_status
  • Number
  • 1
  • 策略状态,1:在线,0:下线
  • reason_tag_list
  • ShowTagVo []
  • 标签
  • └ code
  • String
  • category_preferred
  • 标签code
  • └ color
  • String
  • #FF4D4
  • 展示文案
  • └ name
  • String
  • 类目常用对标
  • 背景颜色
  • └ count
  • Number
  • 1
  • 数量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpWordpackageSuggestkrlistRequest req = new UniversalbpWordpackageSuggestkrlistRequest();
UniversalbpWordpackageSuggestkrlistRequest.TopServiceContext obj1 = new UniversalbpWordpackageSuggestkrlistRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpWordpackageSuggestkrlistRequest.WordPackageSuggestQueryVo obj2 = new UniversalbpWordpackageSuggestkrlistRequest.WordPackageSuggestQueryVo();
obj2.setMaterialId(715017855321L);
obj2.setType("trendTheme");
obj2.setCampaignId(68792485515L);
obj2.setAdgroupId(68792986520L);
req.setWordPackageSuggestQueryVO(obj2);
UniversalbpWordpackageSuggestkrlistResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_wordpackage_suggestkrlist_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <suggest_word_package_v_o_top_bulk_data>
            <suggest_word_package_v_o_list>
                <suggest_word_package_vo>
                    <word_package_id>191014</word_package_id>
                    <word_package_type>20</word_package_type>
                    <word_package_name>碎花</word_package_name>
                    <bid_price>1</bid_price>
                    <impression>10-20</impression>
                    <multi_factor>10.0</multi_factor>
                    <theme_word_list>
                        <string>[&quot;碎花&quot;]</string>
                    </theme_word_list>
                    <simple_word_list>
                        <string>[&quot;碎花裙&quot;</string>
                        <string>&quot;碎花连衣裙&quot;</string>
                        <string>&quot;碎花连衣裙女&quot;</string>
                        <string>&quot;法式碎花裙&quot;]</string>
                    </simple_word_list>
                    <relevance_type>3</relevance_type>
                    <strategy_list>
                        <word_package_strategy_vo>
                            <strategy_id>2</strategy_id>
                            <strategy_name>好词优选</strategy_name>
                            <bid_price>2.23</bid_price>
                            <online_status>1</online_status>
                            <reason_tag_list>
                                <show_tag_vo>
                                    <code>category_preferred</code>
                                    <color>#FF4D4</color>
                                    <name>类目常用对标</name>
                                </show_tag_vo>
                            </reason_tag_list>
                        </word_package_strategy_vo>
                    </strategy_list>
                </suggest_word_package_vo>
            </suggest_word_package_v_o_list>
            <count>1</count>
        </suggest_word_package_v_o_top_bulk_data>
    </result>
</universalbp_wordpackage_suggestkrlist_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

返回
顶部