淘宝开放平台

登录
文档中心 > API类目 > 手淘用户增长

taobao.growth.reaching.suggestion.query (厂商生态推荐信息查询)

厂商生态推荐信息查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
suggestion_context SuggestionContextParam 必须 请求参数
  • device_id
  • DeviceIdParam
  • 必须
  • 设备信息
  • └ os
  • String
  • 必须
  • Android
  • 操作系统： Android/iOS/Windows/macOS
  • └ is_md5
  • Boolean
  • 必须
  • false
  • 是否 md5 hash 值
  • └ type
  • String
  • 必须
  • oaid
  • 设备标识类型： oaid/idfa/imei/caid1/caid2
  • └ value
  • String
  • 必须
  • 1fe9a970-efbb-29e0-0bdd-f5dbbf751ab5
  • 设备标识内容
  • └ site_id
  • String
  • 可选
  • testSite
  • 不同媒体资源位
  • └ weather
  • String
  • 可选
  • 1
  • 天气代码，可空。1：晴, 2：晴（夜）, 3：多云, 4：多云（夜）, 5：阴, 6：阴（夜）, 7：雾, 8：雾（夜）, 9：霾, 10：霾（夜）, 11：雨, 12：雨（夜）, 13：雪, 14：雪（夜）
  • └ region
  • String
  • 可选
  • 杭州
  • 地域
  • └ sex
  • String
  • 可选
  • m
  • 性别：m/f
  • └ age
  • Number
  • 可选
  • 18
  • 年龄
  • temperature
  • Temperature
  • 可选
  • 温度，包括最高和最低
  • └ highest
  • String
  • 可选
  • 26
  • 当日最高温度
  • └ lowest
  • String
  • 可选
  • 18
  • 当日最低温度
  • └ extra
  • String
  • 可选
  • isStressTest:false
  • 附加参数，可用于传递一些非业务参数，如是否压测流量("isStressTest":true)等。格式为：key1:value1,key2:value2
wanted_size Number 必须 1
  • 默认值：1
    		•  需要的数据量

    响应参数

    名称 类型 示例值 描述
    suggestions SuggestionDTO [] 推荐信息列表
    • └ title
    • String
    • 标题
    • 标题
    • └ sub_title
    • String
    • 副标题
    • 副标题
    • └ icon_url
    • String
    • https://gw.alicdn.com/imgextra/i4/O1CN011hBDf61c1MoJGSsKF_!!6000000003540-2-tps-56-56.png
    • 图标链接
    • └ deeplink_url
    • String
    • tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&module=h5&bootImage=0&h5Url=https%3A%2F%2Fs.m.taobao.com%2Fh5%3Fq%3D%25E9%2592%2588%25E7%25BB%2587%25E5%25BC%2580%25E8%25A1%25AB%25E6%2598%25A5%25E6%25AC%25BE%26qlist_id%3DYrUVny%26qlist_ranking%3D2%26qlist_template%3Dhot_rank_content%26from%3Dnt_hotsearch-bangdan%26channelSrp%3Dfuyiping&bc_fl_src=growth_dhh_2200803434487_os-hotsearch-1069565676-huawei&backURL=search%3A%2F%2Fcom.huawei.search%2Fhotword
    • 唤端链接
    • └ exposure_url
    • String
    • https://wcp.taobao.com/adstrack/track.json?action=2&app=1&channel=__CHANNELID__&oaidMd5=__DEVICEID__&advertiserId=__ADVERTISERID__&adid=__ADID__&cid=__CID__&requestId=__REQUESTID__
    • 曝光上报链接
    • └ click_url
    • String
    • https://wcp.taobao.com/adstrack/track.json?action=2&app=1&channel=__CHANNELID__&oaidMd5=__DEVICEID__&advertiserId=__ADVERTISERID__&adid=__ADID__&cid=__CID__&requestId=__REQUESTID__
    • 点击上报链接
    • └ text
    • String
    • 文案
    • 文案内容
    • └ material_id
    • String
    • 素材id
    • 素材id
    • └ h5_url
    • String
    • https://market.m.taobao.com/app/starlink/wakeup-transit/pages/download?star_id=4488&slk_force_set_request=true
    • 未装端时备用的h5url
    • └ image_url
    • String
    • http://img.alicdn.com/imgextra/i4/6000000006840/O1CN01n95DHP20OlwZsmYiC_!!6000000006840-0-tmap.jpg
    • 主图url
    is_offering Boolean true 是否参竞
    exposure_url String https://wcp.taobao.com/adstrack/track.json?action=2&app=1&channel=__CHANNELID__&oaidMd5=__DEVICEID__&advertiserId=__ADVERTISERID__&adid=__ADID__&cid=__CID__&requestId=__REQUESTID__ 列表维度曝光上报链接
    extra ExtraDTO 更多内容
    • └ text
    • String
    • 精选好物，尽在百亿补贴！
    • 文案，可空，为空时使用厂商侧兜底文案
    • └ h5_url
    • String
    • https://market.m.taobao.com/app/asr-pages/muise-tb-hot-list/p/tb-hot-list?wh_weex=true&wx_navbar_transparent=true&defaultTab=0&channelSrp=fuyiping&g_channelSrp=fuyiping
    • 未安装淘宝时 h5 页面跳
    • └ deeplink_url
    • String
    • tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&bootImage=0 &h5Url=https%3A%2F%2Fmarket.m.taobao.com%2Fapp%2Fasr-pages%2Fmuise-tb-hot-list%2Fp%2Ftb-hot-list%3F wh_weex%3Dtrue%26wx_navbar_transparent%3Dtrue%26defaultTab%3D0%26channelSrp%3Dfuyiping%26g_channelSrp%3Dfuyiping &bc_fl_src=growth_dhh_2200803434487_os-hotsearch-1069565676-huawei&afc_route=1
    • App跳转链接
    • └ exposure_url
    • String
    • https://wcp.taobao.com/adstrack/track.json?action=2&app=1&channel=__CHANNELID__&oaidMd5=__DEVICEID__&advertiserId=__ADVERTISERID__&adid=__ADID__&cid=__CID__&requestId=__REQUESTID__
    • “更多”模块曝光上报链接
    • └ click_url
    • String
    • https://wcp.taobao.com/adstrack/track.json?action=2&app=1&channel=__CHANNELID__&oaidMd5=__DEVICEID__&advertiserId=__ADVERTISERID__&adid=__ADID__&cid=__CID__&requestId=__REQUESTID__
    • “更多”模块点击上报链接,

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    GrowthReachingSuggestionQueryRequest req = new GrowthReachingSuggestionQueryRequest();
    GrowthReachingSuggestionQueryRequest.SuggestionContextParam obj1 = new GrowthReachingSuggestionQueryRequest.SuggestionContextParam();
    GrowthReachingSuggestionQueryRequest.DeviceIdParam obj2 = new GrowthReachingSuggestionQueryRequest.DeviceIdParam();
    obj2.setOs("Android");
    obj2.setIsMd5(false);
    obj2.setType("oaid");
    obj2.setValue("1fe9a970-efbb-29e0-0bdd-f5dbbf751ab5");
    obj1.setDeviceId(obj2);
    obj1.setSiteId("testSite");
    obj1.setWeather("1");
    obj1.setRegion("杭州");
    obj1.setSex("m");
    obj1.setAge(18L);
    GrowthReachingSuggestionQueryRequest.Temperature obj3 = new GrowthReachingSuggestionQueryRequest.Temperature();
    obj3.setHighest("26");
    obj3.setLowest("18");
    obj1.setTemperature(obj3);
    obj1.setExtra("isStressTest:false");
    req.setSuggestionContext(obj1);
    req.setWantedSize(1L);
    GrowthReachingSuggestionQueryResponse rsp = client.execute(req);
    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
    <growth_reaching_suggestion_query_response>
        <suggestions>
            <suggestion_d_t_o>
                <title>标题</title>
                <sub_title>副标题</sub_title>
                <icon_url>https://gw.alicdn.com/imgextra/i4/O1CN011hBDf61c1MoJGSsKF_!!6000000003540-2-tps-56-56.png</icon_url>
                <deeplink_url>tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&amp;module=h5&amp;bootImage=0&amp;h5Url=https%3A%2F%2Fs.m.taobao.com%2Fh5%3Fq%3D%25E9%2592%2588%25E7%25BB%2587%25E5%25BC%2580%25E8%25A1%25AB%25E6%2598%25A5%25E6%25AC%25BE%26qlist_id%3DYrUVny%26qlist_ranking%3D2%26qlist_template%3Dhot_rank_content%26from%3Dnt_hotsearch-bangdan%26channelSrp%3Dfuyiping&amp;bc_fl_src=growth_dhh_2200803434487_os-hotsearch-1069565676-huawei&amp;backURL=search%3A%2F%2Fcom.huawei.search%2Fhotword</deeplink_url>
                <exposure_url>https://wcp.taobao.com/adstrack/track.json?action=2&amp;app=1&amp;channel=__CHANNELID__&amp;oaidMd5=__DEVICEID__&amp;advertiserId=__ADVERTISERID__&amp;adid=__ADID__&amp;cid=__CID__&amp;requestId=__REQUESTID__</exposure_url>
                <click_url>https://wcp.taobao.com/adstrack/track.json?action=2&amp;app=1&amp;channel=__CHANNELID__&amp;oaidMd5=__DEVICEID__&amp;advertiserId=__ADVERTISERID__&amp;adid=__ADID__&amp;cid=__CID__&amp;requestId=__REQUESTID__</click_url>
                <text>文案</text>
                <material_id>素材id</material_id>
                <h5_url>https://market.m.taobao.com/app/starlink/wakeup-transit/pages/download?star_id=4488&amp;slk_force_set_request=true</h5_url>
                <image_url>http://img.alicdn.com/imgextra/i4/6000000006840/O1CN01n95DHP20OlwZsmYiC_!!6000000006840-0-tmap.jpg</image_url>
            </suggestion_d_t_o>
        </suggestions>
        <is_offering>true</is_offering>
        <exposure_url>https://wcp.taobao.com/adstrack/track.json?action=2&amp;app=1&amp;channel=__CHANNELID__&amp;oaidMd5=__DEVICEID__&amp;advertiserId=__ADVERTISERID__&amp;adid=__ADID__&amp;cid=__CID__&amp;requestId=__REQUESTID__</exposure_url>
        <extra>
            <text>精选好物，尽在百亿补贴！</text>
            <h5_url>https://market.m.taobao.com/app/asr-pages/muise-tb-hot-list/p/tb-hot-list?wh_weex=true&amp;wx_navbar_transparent=true&amp;defaultTab=0&amp;channelSrp=fuyiping&amp;g_channelSrp=fuyiping</h5_url>
            <deeplink_url>tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&amp;bootImage=0 &amp;h5Url=https%3A%2F%2Fmarket.m.taobao.com%2Fapp%2Fasr-pages%2Fmuise-tb-hot-list%2Fp%2Ftb-hot-list%3F wh_weex%3Dtrue%26wx_navbar_transparent%3Dtrue%26defaultTab%3D0%26channelSrp%3Dfuyiping%26g_channelSrp%3Dfuyiping &amp;bc_fl_src=growth_dhh_2200803434487_os-hotsearch-1069565676-huawei&amp;afc_route=1</deeplink_url>
            <exposure_url>https://wcp.taobao.com/adstrack/track.json?action=2&amp;app=1&amp;channel=__CHANNELID__&amp;oaidMd5=__DEVICEID__&amp;advertiserId=__ADVERTISERID__&amp;adid=__ADID__&amp;cid=__CID__&amp;requestId=__REQUESTID__</exposure_url>
            <click_url>https://wcp.taobao.com/adstrack/track.json?action=2&amp;app=1&amp;channel=__CHANNELID__&amp;oaidMd5=__DEVICEID__&amp;advertiserId=__ADVERTISERID__&amp;adid=__ADID__&amp;cid=__CID__&amp;requestId=__REQUESTID__</click_url>
        </extra>
    </growth_reaching_suggestion_query_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

    我要提问
    返回
    顶部