1. 发表帖子
淘宝联盟论坛
联盟通告
+发表新贴
  • 回复
  • 助威
  • 收藏
楼层直达
返回顶部
  • 【汇总通知帖】淘宝联盟API最新变动通知20191008
  • 联盟委员会发表于2019-07-16 17:56浏览(13386)回复(1)

API——10月8日变更通知
关于“预售订单”的数据同步和相关规则 https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9325763

API——8月29日变更通知

订单报表的类目名称信息变更通知 https://tbk.bbs.taobao.com/detail.html?postId=9286948

API——7月23日变更通知
权限包拆包、物料类老API下线 http://tbk.bbs.taobao.com/detail.html?postId=9239853&page=0&rndId=3382#M_1

API——5月10日变更通知
订单报表升级(订单API同步升级,老订单API下线)https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9169586

联盟委员会发表于 2019-08-21 10:40 1楼

17API——7月23日变更通知


为了帮助淘宝客对联盟API有更简单清晰的认识和了解,现特将联盟的API,按照各具体功能包装出独立的权限包,即一个权限包,包含了同功能所需要的API,从权限包名称以及API名称,基本可了解该API的功能。同时将功能雷同的API收到一个API中使用,降低淘宝客的使用和认知成本。


本次变动包含两件事情及节奏安全:

1、权限包拆分:“淘宝客基础API”、“淘宝客【推广者】商品或店铺链接转换”、“淘宝客【推广者】三方分成链接转换”三个权限包,所包含的API,将根据独立的功能进行拆包至对应功能的API权限包中——7月23日这周完成拆分,请关注:开放平台-控制台-联盟生成的appkey  中对应的权限包

2、部分API下线迁移至替代的API——9月20日老API全部关闭(提供2个月的时间进行调整),但近15天无调用的将逐步先行收回权限。9月1日起将下线的API不再维护,调用量级会受限,最终9月20日全面下线。


具体说明:

一、权限包拆分

1、前提说明

API主要分为:推广者使用、服务商使用两大类,其中部分API是两者公用的,在API权限包和API名称中,都有标识:

  • 推广者:本身是做引流的,含入口、导购、社交、内容、线下类的淘宝客——推广者适用的API:包和api名称中,都标注了“推广者”
  • 服务商:服务淘宝客的,目前API涉及到的是工具服务商(邀请制)——服务商适用的API:包和api名称中,都标注了“服务商”
  • 推广者和服务商都可使用的API:包和api名称中,都标注了“公用”

具体的名称和内容,请看《淘宝客API介绍总帖》https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8127005


2、具体权限包拆分

拆分逻辑:近60天内有调用的appkey,将被拆到对应权限包内,若当下未被迁移到新权限包的appkey,上表中“默认开放”的权限包,媒体可自行在开放平台的控制台,联盟对应的appkey内(联盟合作网站、联盟合作APP),去点“申请权限”就可自动拥有,参考截图如下。对于不是默认开放的,服务商的两个权限包,需要对应运营来申请。



①原来的API权限包:淘宝客基础API。将被拆分成以下的权限包:

API地址

API名称

权限包名称

调整说明

taobao.tbk.item.info.get

淘宝客-公用-淘宝客商品详情查询(简版)

淘宝客【公用】物料信息查询

默认开放,即联盟的appkey默认就可申请这个权限包

taobao.tbk.coupon.get

淘宝客-公用-阿里妈妈推广券详情查询

taobao.tbk.item.recommend.get

淘宝客-公用-商品关联推荐

淘宝客【公用】关联推荐

默认开放,即联盟的appkey默认就可申请这个权限包

taobao.tbk.shop.recommend.get

淘宝客-公用-店铺关联推荐

taobao.tbk.dg.material.optional

淘宝客-推广者-物料搜索

淘宝客【推广者】物料搜索

默认开放,即联盟的appkey默认就可申请这个权限包

taobao.tbk.shop.get

淘宝客-推广者-店铺搜索

taobao.tbk.dg.optimus.material

淘宝客-推广者-物料精选

淘宝客【推广者】物料精选

默认开放,即联盟的appkey默认就可申请这个权限包

taobao.tbk.uatm.favorites.get

淘宝客-推广者-选品库宝贝列表

淘宝客【推广者】选品库

默认开放,即联盟的appkey默认就可申请这个权限包

taobao.tbk.uatm.favorites.item.get

淘宝客-推广者-选品库宝贝信息

taobao.tbk.content.get

淘宝客-推广者-图文内容输出

淘宝客【推广者】图文物料

默认开放,即联盟的appkey默认就可申请这个权限包

taobao.tbk.content.effect.get

淘宝客-推广者-图文内容效果数据

taobao.tbk.dg.newuser.order.get

淘宝客-推广者-新用户订单明细查询

淘宝客【推广者】新用户订单及数据查询

默认开放,即联盟的appkey默认就可申请这个权限包

taobao.tbk.dg.newuser.order.sum

淘宝客-推广者-拉新活动对应数据查询

taobao.tbk.activitylink.get

淘宝客-推广者-官方活动转链

淘宝客【推广者】官方活动转链

默认开放,即联盟的appkey默认就可申请这个权限包

taobao.tbk.tpwd.create

淘宝客-公用-淘口令生成

淘宝客【公用】淘口令生成

默认开放,即联盟的appkey默认就可申请这个权限包

taobao.tbk.ju.tqg.get

 淘抢购api

淘宝客【推广者】聚划算&淘抢购商品获取

默认开放,即联盟的appkey默认就可申请这个权限包

taobao.ju.items.search

 聚划算商品搜索接口

taobao.tbk.sc.optimus.material

淘宝客-服务商-物料精选

淘宝客【服务商】物料精选

针对服务商的(邀请制),不会默认开放

taobao.tbk.sc.newuser.order.get

淘宝客-服务商-新用户订单明细查询

淘宝客【服务商】新用户订单及数据查询

针对服务商的(邀请制),不会默认开放

taobao.tbk.sc.newuser.order.sum

淘宝客-服务商-拉新活动对应数据查询

taobao.tbk.item.get

 淘宝客商品查询

淘宝客基础API(权限包功能已拆分,剩余API将下线,具体请看权限包介绍)

不再对外开放,将下线

taobao.tbk.dg.item.coupon.get

 好券清单API【导购】


②原来的API权限包:淘宝客【推广者】商品或店铺链接转换。拆分成:

API地址

API名称

所在权限包名称

默认

taobao.tbk.item.convert

淘宝客-推广者-商品链接转换

淘宝客【推广者】商品或店铺链接转换

不会默认开放

taobao.tbk.shop.convert

淘宝客-推广者-店铺链接转换

taobao.tbk.tpwd.convert

淘宝客-推广者-淘口令解析&转链

淘宝客【推广者】淘口令解析&转链

不会默认开放


③原来的API权限包:淘宝客【推广者】三方分成链接转换。拆分成:

API地址

API名称

所在权限包名称

默认

taobao.tbk.item.share.convert

淘宝客-推广者-商品三方分成链接转换

淘宝客【推广者】三方分成链接转换

不会默认开放

taobao.tbk.shop.share.convert

淘宝客-推广者-店铺三方分成链接转换

taobao.tbk.tpwd.share.convert

淘宝客-推广者-淘口令解析&三方分成转链

淘宝客【推广者】淘口令解析&三方分成转链

不会默认开放


④原来的API权限包:淘宝客-媒体-优惠券精品物料包。拆分成:

API地址

API名称

所在权限包名称

默认

taobao.tbk.itemid.coupon.get

淘宝客-推广者-根据宝贝id批量查询优惠券

淘宝客【推广者】宝贝id查优惠券

不会默认开放

taobao.tbk.dg.coupon.realtime.recommend

好券直播API【导购】

淘宝客-媒体-优惠券精品物料包

不再对外开放,将下线

taobao.tbk.dg.coupon.brand.recommend

品牌券API【导购】



二、API下线迁移至可替代的API

联盟API中,对外提供的物料类接口,我们进行了整合,原来提供的分散的物料获取API,会统一由“物料搜索API+物料id”和“物料精选API+物料id”的方式替代

【具体API说明如下】

  • 1、以下针对淘宝客推广者,api将废弃,由其他api替代

当前API

所在权限包

替代的API(后续可使用)

替代的API是否默认开

taobao.tbk.item.get  淘宝客商品查询

淘宝客基础API

taobao.tbk.dg.material.optional 淘宝客-推广者-物料搜索,字段更全面

默认开放

taobao.tbk.dg.item.coupon.get 好券清单API【导购】

淘宝客基础API

taobao.tbk.dg.optimus.material 淘宝客-推广者-物料精选,入参物料id

默认开放

taobao.tbk.item.guess.like  淘宝客商品猜你喜欢

淘宝客-媒体-商品猜你喜欢

taobao.tbk.dg.optimus.material 淘宝客-推广者-物料精选,入参物料id6708

默认开放(需先在联盟PC后台签订协议,才可以使用物料id)

taobao.tbk.dg.coupon.realtime.recommend  好券直播API【导购】

淘宝客-媒体-优惠券精品物料包

taobao.tbk.dg.optimus.material 淘宝客-推广者-物料精选,入参物料id

默认开放

taobao.tbk.dg.coupon.brand.recommend  品牌券API【导购】

淘宝客-媒体-优惠券精品物料包

taobao.tbk.dg.optimus.material 淘宝客-推广者-物料精选,入参物料id

默认开放

注意:

更多物料精选的物料id获取,可查看https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8576096

原来的“猜你喜欢API”等同于想在的“智能导购”,需要媒体在淘宝联盟pub后台,签订协议,然后再使用API+物料id进行使用,如下图提示,签署协议后,即可获取。



  • 2、以下针对服务商,api将废弃,由其他api替代(非服务商,即当前没有开通替代的API,请直接使用推广者的API)

API(要下线)

当前所在权限包

替代的API(可使用)

替代的API是否默认开

taobao.tbk.sc.coupon.realtime.recommend好券直播API【社交】

淘宝客-工具-官方物料高级包

taobao.tbk.sc.optimus.material  淘宝客-服务商-物料精选,入参物料id

小二邀约制

taobao.tbk.sc.coupon.brand.recommend品牌券API【社交】

淘宝客-工具-官方物料高级包

taobao.tbk.sc.optimus.material  淘宝客-服务商-物料精选,入参物料id

小二邀约制

taobao.tbk.item.coupon.get 单品加券检索api

淘宝客-工具-官方物料基础包

taobao.tbk.sc.material.optional淘宝客-服务商-物料搜索,字段更全面

小二邀约制

taobao.tbk.sc.coupon.smart.recommend 淘宝客定向推荐商品API【社交】

淘宝客-媒体-智能推荐物料包

小二邀约制

更多物料精选的物料id获取,可查看https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8576096

0
回复
只看作者