个性化推荐商品获取,支持入参对应的“推广位”和官方提供的“物料id”,获取指定物料信息和推广链接。
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| material_id | Number | 可选 | 123 | 官方提供的物料Id | |
| adzone_id | Number | 必须 | 123 | 推广位id,mm_xxx_xxx_12345678三段式的最后一段数字(登录pub.alimama.com推广管理-推广位管理中查询) | |
| page_size | Number | 可选 | 20 |
|
页大小,默认20,1~100 |
| page_no | Number | 可选 | 1 |
|
第几页,默认:1 |
| device_type | String | 可选 | uvid | 智能匹配,支持uvid/scdId | |
| device_value | String | 可选 | xxx | 智能匹配-uvid/scdId的值 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| result_list | MapData [] | resultList | |
|
|||
| uvid_msg | String | 123 | uvid结果信息,传入但未使用uvid时会返回原因 |
| scd_id_msg | String | 123 | scd_id结果信息 |
| material_id_msg | String | 123 | 描述本次商品推荐使用的物料信息 |
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgInterestItemsGetRequest req = new TbkDgInterestItemsGetRequest();
req.setMaterialId(123L);
req.setAdzoneId(123L);
req.setPageSize(20L);
req.setPageNo(1L);
req.setDeviceType("uvid");
req.setDeviceValue("xxx");
TbkDgInterestItemsGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());
<tbk_dg_interest_items_get_response>
<result_list>
<map_data>
<item_id>qeqscd1231-uqwenqe</item_id>
<item_basic_info>
<title>复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款</title>
<short_title>九分裤显瘦高腰韩版</short_title>
<pict_url>//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</pict_url>
<white_image>https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</white_image>
<level_one_category_id>1</level_one_category_id>
<level_one_category_name>美妆</level_one_category_name>
<category_id>162201</category_id>
<category_name>牛仔裤</category_name>
<seller_id>123</seller_id>
<user_type>1</user_type>
<shop_title>魔黛娅内衣旗舰店</shop_title>
<volume>30</volume>
<sub_title>吉品鲍鱼 关西参</sub_title>
<brand_name>淘宝心选</brand_name>
<annual_vol>1万+</annual_vol>
</item_basic_info>
<price_promotion_info>
<reserve_price>102.00</reserve_price>
<zk_final_price>79.9</zk_final_price>
<final_promotion_price>69.9</final_promotion_price>
<final_promotion_path_list>
<final_promotion_path_map_data>
<promotion_title>商品券</promotion_title>
<promotion_desc>满7999减1300</promotion_desc>
<promotion_fee>1300.00</promotion_fee>
<promotion_start_time>1661184000000</promotion_start_time>
<promotion_end_time>1661788799000</promotion_end_time>
<promotion_id>xx</promotion_id>
</final_promotion_path_map_data>
</final_promotion_path_list>
<future_activity_promotion_price>99.5</future_activity_promotion_price>
<future_activity_promotion_path_list>
<future_activity_promotion_path_map_data>
<promotion_title>商品券</promotion_title>
<promotion_desc>满7999减1300</promotion_desc>
<promotion_fee>1300.00</promotion_fee>
<promotion_start_time>1661184000000</promotion_start_time>
<promotion_end_time>1661788799000</promotion_end_time>
</future_activity_promotion_path_map_data>
</future_activity_promotion_path_list>
<promotion_tag_list>
<promotion_tag_map_data>
<tag_name>88VIP</tag_name>
</promotion_tag_map_data>
</promotion_tag_list>
<predict_rounding_up_price>56.1</predict_rounding_up_price>
<predict_rounding_up_price_desc>需买1件</predict_rounding_up_price_desc>
<more_promotion_list>
<more_promotion_map_data>
<promotion_title>满件折</promotion_title>
<promotion_desc>2件9折</promotion_desc>
<promotion_start_time>1661222400000</promotion_start_time>
<promotion_end_time>1662393600000</promotion_end_time>
<promotion_id>xx</promotion_id>
</more_promotion_map_data>
</more_promotion_list>
<predict_rounding_up_path_list>
<predict_rounding_up_path_map_data>
<promotion_title>店铺优惠</promotion_title>
<promotion_desc>再买1件,可参与2件5折</promotion_desc>
</predict_rounding_up_path_map_data>
</predict_rounding_up_path_list>
</price_promotion_info>
<publish_info>
<income_rate>5.50</income_rate>
<click_url>//item.taobao.com/item.htm?id=556633720749&scm=1007.16190.92234.0&pvid=41362290-fa0b-4252-b172-6afc9c00e2c8&app_pvid=0ab0fac715095507006577956e</click_url>
<coupon_share_url>//uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8</coupon_share_url>
<sp_campaign_list>
<sp_campaign_d_t_o>
<sp_cid>123</sp_cid>
<sp_name>定向计划活动1</sp_name>
<sp_rate>1550表示15.5%</sp_rate>
<sp_lock_status>0</sp_lock_status>
<sp_apply_link>http://pub.alimama.com/portal/promo/shop/campaign/detail.htm?mode=info&campaignId=1000492470&creatorId=98836808&breadcrumb=false</sp_apply_link>
<sp_status>1</sp_status>
</sp_campaign_d_t_o>
</sp_campaign_list>
<future_activity_commission_rate>1550表示15.5%</future_activity_commission_rate>
<future_activity_time>1665504000000</future_activity_time>
<income_info>
<commission_rate>55</commission_rate>
<commission_amount>12</commission_amount>
<subsidy_rate>11</subsidy_rate>
<subsidy_amount>4</subsidy_amount>
<subsidy_upper_limit>10</subsidy_upper_limit>
</income_info>
</publish_info>
<tmall_rank_info>
<tmall_rank_text>白茶热销榜·第5名</tmall_rank_text>
<tmall_rank_url>https://pages.tmall.com/wow/a/act/tmall/dailygroup/16220/16661/wupr?wh_pid=daily-459438&disableNav=YES</tmall_rank_url>
</tmall_rank_info>
<presale_info>
<presale_start_time>1567440000000</presale_start_time>
<presale_end_time>1567440000000</presale_end_time>
<presale_tail_start_time>1567440000000</presale_tail_start_time>
<presale_tail_end_time>1567440000000</presale_tail_end_time>
<presale_deposit>100</presale_deposit>
<presale_discount_fee_text>付定金立减5元</presale_discount_fee_text>
</presale_info>
<topn_info>
<topn_quantity>3000</topn_quantity>
<topn_total_count>3000</topn_total_count>
<topn_start_time>1937297392332</topn_start_time>
<topn_end_time>1937297392332</topn_end_time>
<topn_rate>30</topn_rate>
</topn_info>
</map_data>
</result_list>
<uvid_msg>123</uvid_msg>
<scd_id_msg>123</scd_id_msg>
<material_id_msg>123</material_id_msg>
</tbk_dg_interest_items_get_response>
<error_response>
<code>50</code>
<msg>Remote service error</msg>
<sub_code>isv.invalid-parameter</sub_code>
<sub_msg>非法参数</sub_msg>
</error_response>
| 错误码 | 错误描述 | 解决方案 |
|---|