淘宝开放平台

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

直通车API

taobao.universalbp.bidword.qscore (实时质量分查询)

实时质量分查询，如果不传词id则查询单元下所有的词的质量分

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
qscore_real_query_v_o QscoreRealQueryVo 必须 qscoreRealQueryVO
  • └ campaign_id
  • Number
  • 可选
  • 69061654043
  • 计划id
  • └ adgroup_id
  • Number
  • 可选
  • 69169920066
  • 单元id
  • └ bidword_id_list
  • Number []
  • 可选
  • [1221274792781]
  • 词id集合

响应参数

名称 类型 示例值 描述
result TopResult 结果体
  • info
  • TopInfo
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • qscore_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • qscore_v_o_list
  • QscoreVo []
  • 批量结果集
  • └ campaign_id
  • Number
  • 69061654043
  • 计划id
  • └ adgroup_id
  • Number
  • 69169920066
  • 单元id
  • └ bidword_id
  • Number
  • 1221274792781
  • 词id
  • └ word
  • String
  • 词
  • 原词
  • └ qscore
  • String
  • 6.00
  • 质量分
  • └ creative_score
  • String
  • 6.00
  • 创意质量
  • └ cust_score
  • String
  • 6.00
  • 专家体验
  • └ category_match
  • Boolean
  • true
  • 类目是否相符
  • └ brand_match
  • Boolean
  • true
  • 品牌是否相符
  • └ thedate
  • Date
  • 2023-09-10
  • 时间
  • └ count
  • Number
  • 1
  • 数量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpBidwordQscoreRequest req = new UniversalbpBidwordQscoreRequest();
UniversalbpBidwordQscoreRequest.TopServiceContext obj1 = new UniversalbpBidwordQscoreRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpBidwordQscoreRequest.QscoreRealQueryVo obj2 = new UniversalbpBidwordQscoreRequest.QscoreRealQueryVo();
obj2.setCampaignId(69061654043L);
obj2.setAdgroupId(69169920066L);
obj2.setBidwordIdList(new Long[] { 1221274792781 };
);
req.setQscoreRealQueryVO(obj2);
UniversalbpBidwordQscoreResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<universalbp_bidword_qscore_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <qscore_v_o_top_bulk_data>
            <qscore_v_o_list>
                <qscore_vo>
                    <campaign_id>69061654043</campaign_id>
                    <adgroup_id>69169920066</adgroup_id>
                    <bidword_id>1221274792781</bidword_id>
                    <word>词</word>
                    <qscore>6.00</qscore>
                    <creative_score>6.00</creative_score>
                    <cust_score>6.00</cust_score>
                    <category_match>true</category_match>
                    <brand_match>true</brand_match>
                    <thedate>2023-09-10</thedate>
                </qscore_vo>
            </qscore_v_o_list>
            <count>1</count>
        </qscore_v_o_top_bulk_data>
    </result>
</universalbp_bidword_qscore_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部