文档中心 > API类目 > 国际站外贸直通车API

alibaba.scbp.ad.keyword.list.relevant.products (查询和词匹配的推广产品)

查询和词匹配的推广产品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_context TopContextDto 必须 用户信息
  • └ product_line_id
  • Number
  • 必须
  • 110101
  • 产品线id
  • └ product_id
  • Number
  • 必须
  • 110101010
  • 产品id
campaign_id Number 必须 1 计划id
keyword String 必须 test
  • 默认值:test
  • 关键词

    响应参数

    名称 类型 示例值 描述
    result_list RelevantProductDTO [] 优推品信息返回
    • └ img_url
    • String
    • http//test.png
    • 品图片链接
    • └ qs_star
    • Number
    • 3
    • 星级
    • └ product_id
    • Number
    • 125447575
    • 品id
    • └ product_name
    • String
    • test
    • 品名称
    • └ reason_list
    • String []
    • 推荐理由
    • └ is_preferential
    • Boolean
    • true
    • 是否优推
    • └ ad_group_id
    • Number
    • 154659846
    • 操作优推品得主键id

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaScbpAdKeywordListRelevantProductsRequest req = new AlibabaScbpAdKeywordListRelevantProductsRequest();
    AlibabaScbpAdKeywordListRelevantProductsRequest.TopContextDto obj1 = new AlibabaScbpAdKeywordListRelevantProductsRequest.TopContextDto();
    obj1.setProductLineId(110101L);
    obj1.setProductId(110101010L);
    req.setTopContext(obj1);
    req.setCampaignId(1L);
    req.setKeyword("test");
    AlibabaScbpAdKeywordListRelevantProductsResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_scbp_ad_keyword_list_relevant_products_response>
        <result_list>
            <relevant_product_d_t_o>
                <img_url>http//test.png</img_url>
                <qs_star>3</qs_star>
                <product_id>125447575</product_id>
                <product_name>test</product_name>
                <is_preferential>true</is_preferential>
                <ad_group_id>154659846</ad_group_id>
            </relevant_product_d_t_o>
        </result_list>
    </alibaba_scbp_ad_keyword_list_relevant_products_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

    返回
    顶部