开发者你好:
为更好地满足小程序实际应用场景,并为开发者提供更优质的服务,平台将于近期对部分小程序能力进行权限调整,包括接口回收和接口改造两种类型。
第二期能力权限调整共涉及32个能力接口,自公告发布日2023年11月16日起:
- 对于接口回收能力:
1.新创建小程序将在公告发布日起无法调用头条互动组件、抖音直播数据(2)、抖音直播数据(3)能力,共计20个接口;将在公告发布30日后无法调用包含埋点上报、关注头条号和其他非开放API,共计5个接口。
2.已创建小程序将在公告发布日起无法调用头条互动组件、抖音直播数据能力(2),共计15个接口;将在公告发布30日后无法调用抖音直播数据(3)能力、埋点上报、关注头条号和其他非开放API,共计10个接口。
- 对于接口改造能力:
1.新创建小程序将在公告发布日起无法调用抖音视频页、日历、快捷桌面、头像昵称(旧)能力,共计4个接口;将在公告发布30日后无法调用跳转直播间、直播呼吸灯、直播预览流能力,共计3个接口。
2.已创建小程序将在公告发布30日后无法调用抖音视频页 、跳转直播间、直播呼吸灯、直播预览流、日历、快捷桌面能力,共计6个接口;头像昵称(旧)能力接口调用不受影响。
注明:
1、小程序能力权限调整将于抖音客户端27.7版本起生效
2、具体权限限制时间请以接口回收/改造能力列表中新创建/已创建小程序禁止调用接口时间为准)
3、公告发布30日后:指2023年12月16日起
4、如开发者代码调整时间不足,请见文末FAQ问题3,提交延期申请表单
5、往期回顾:小程序能力回收第一期调整通知
能力列表
1.接口回收能力
请开发者在接口禁止调用时间前完成代码调整,平台将在整改期到期后进行能力下线处理。如开发者未按期完成代码调整,能力下线后,小程序将会出现报错提示或调用此接口将返回失败。
接口名称 | 能力名称 | 权限调整方式 | 接口文档 | 能力/接口描述 | 新创建小程序禁止调用接口时间 | 已创建小程序禁止调用接口时间 |
tt.showInteractionBar | 头条互动组件 | 接口回收 | 显示互动组件,只支持在今日头条 APP 上使用。 | 2023年11月16日 | 2023年11月16日 | |
tt.hideInteractionBar | 头条互动组件 | 接口回收 | 隐藏互动组件,只支持在今日头条 APP 上使用。 | 2023年11月16日 | 2023年11月16日 | |
tt.LiveReportContext.orderConfirmPageShow | 抖音直播数据(2) | 接口回收 | 1. 获取直播间基础信息、用户信息 2. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.LiveReportContext.orderSubmit | 抖音直播数据(3) | 接口回收 | 1. 获取直播间基础信息、用户信息 3. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.LiveReportContext.productDetailsShow | 抖音直播数据(4) | 接口回收 | 1. 获取直播间基础信息、用户信息 4. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.LiveReportContext.productShareClick | 抖音直播数据(5) | 接口回收 | 1. 获取直播间基础信息、用户信息 5. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.LiveReportContext.shelfShow | 抖音直播数据(6) | 接口回收 | 1. 获取直播间基础信息、用户信息 6. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.getSelfCommentCountDuringPluginRunning | 抖音直播数据(7) | 接口回收 | 1. 获取直播间基础信息、用户信息 7. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.isFollowingAnchor | 抖音直播数据(8) | 接口回收 | 1. 获取直播间基础信息、用户信息 8. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.unsubscribeAudiencesFollowAction | 抖音直播数据(9) | 接口回收 | 1. 获取直播间基础信息、用户信息 9. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.subscribeSpecifiedContentComment | 抖音直播数据(10) | 接口回收 | 1. 获取直播间基础信息、用户信息 10. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.subscribeSpecifiedUserComment | 抖音直播数据(11) | 接口回收 | 1. 获取直播间基础信息、用户信息 11. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.unsubscribeAllSpecifiedContentComment | 抖音直播数据(12) | 接口回收 | 1. 获取直播间基础信息、用户信息 12. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.unsubscribeAllSpecifiedUserComment | 抖音直播数据(13) | 接口回收 | 1. 获取直播间基础信息、用户信息 13. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.onReceiveSpecifiedComment | 抖音直播数据(14) | 接口回收 | 1. 获取直播间基础信息、用户信息 14. 对用户订单、埋点数据进行上报。 | 2023年11月16日 | 2023年11月16日 | |
tt.LiveReportContext.productSelect | 抖音直播数据(3) | 接口回收 | 1. 获取直播间基础信息、用户信息 2. 对用户订单、埋点数据进行上报 | 2023年11月16日 | 2023年12月16日 | |
tt.createLiveReportContext | 抖音直播数据(4) | 接口回收 | 1. 获取直播间基础信息、用户信息 3. 对用户订单、埋点数据进行上报 | 2023年11月16日 | 2023年12月16日 | |
tt.getLiveUserInfo | 抖音直播数据(5) | 接口回收 | 1. 获取直播间基础信息、用户信息 4. 对用户订单、埋点数据进行上报 | 2023年11月16日 | 2023年12月16日 | |
tt.onReceiveAudiencesFollowAction | 抖音直播数据(6) | 接口回收 | 1. 获取直播间基础信息、用户信息 5. 对用户订单、埋点数据进行上报 | 2023年11月16日 | 2023年12月16日 | |
tt.subscribeAudiencesFollowAction | 抖音直播数据(7) | 接口回收 | 1. 获取直播间基础信息、用户信息 6. 对用户订单、埋点数据进行上报 | 2023年11月16日 | 2023年12月16日 | |
tt.sendUmengEventV1 | 埋点上报 | 接口回收 | 历史遗留能力,官网无文档 | 广告页、友盟等上报接口,非开放API | 2023年12月16日 | 2023年12月16日 |
tt.dealUserRelation | 关注头条号 | 接口回收 | 历史遗留能力,官网无文档 | 关注、检查小程序绑定的头条号,非开放API | 2023年12月16日 | 2023年12月16日 |
tt.disablePageScroll | 其他 | 接口回收 | 历史遗留能力,官网无文档 | 历史遗留能力,非开放API | 2023年12月16日 | 2023年12月16日 |
tt.updateShareMenu | 其他 | 接口回收 | 历史遗留能力,官网无文档 | 历史遗留能力,非开放API | 2023年12月16日 | 2023年12月16日 |
tt.onDeviceOrientationChange | 其他 | 接口回收 | 历史遗留能力,官网无文档 | 历史遗留能力,非开放API | 2023年12月16日 | 2023年12月16日 |
2.接口改造能力
请开发者参照接口改造内容,在接口禁止调用时间前完成代码调整,改造内容分为两类:
(1)如涉及新旧接口切换:开发者需要完成能力接入方式的改动(将JS 切换为 button),旧接口将不再进行技术维护,长期可能影响小程序的正常使用。
(2)如涉及关系授权:开发者需要完成品牌号、员工号和合作号并完成授权,将不影响能力的正常使用。
接口名称 | 能力名称 | 权限调整方式 | 接口改造内容 | 接口文档 | 能力/接口描述 | 新创建小程序禁止调用接口时间 | 已创建小程序禁止调用接口时间 |
tt.navigateToVideoView | 抖音视频页 | 接口改造 | 新旧接口切换: | 旧接口文档 新接口文档 | 跳转通过小程序抖音拍摄器发布的视频播放页 | 2023年11月16日 | 2023年12月16日 |
tt.openWebcastRoom | 跳转直播间 | 接口改造 | 关系授权:绑定品牌号、员工号、合作号,并完成授权 | 旧接口文档:tt.openWebcastRoom 新接口文档: | 从小程序跳转到直播间 | 2023年12月16日 | 2023年12月16日 |
aweme-data | 直播呼吸灯 | 接口改造 | 关系授权:绑定品牌号、员工号、合作号,并完成授权 | 小程序展示直播间开播状态,并可跳转至直播间 | 2023年12月16日 | 2023年12月16日 | |
live-preview | 直播预览流 | 接口改造 | 关系授权:绑定品牌号、员工号、合作号,并完成授权 | 小程序实时播放抖音直播间内容,并可跳转至直播间 | 2023年12月16日 | 2023年12月16日 | |
tt.addCalendarEvent | 日历 | 接口改造 | 新旧接口切换: JS 改为button | 历史遗留能力,官网无文档 | 添加用户设备系统日历 | 2023年11月16日 | 2023年12月16日 |
tt.addShortcut | 快捷桌面 | 接口改造 | 新旧接口切换: JS 改为button | 历史遗留能力,官网无文档 | 可以将小程序快捷方式添加到手机桌面上 | 2023年11月16日 | 2023年12月16日 |
tt.getUserInfo | 头像昵称(旧) | 接口改造 | 新旧接口切换: | 旧接口文档: 新接口文档: | 获取已登录用户的基本信息或特殊信息,首次使用的用户会弹出授权提示窗,若用户同意,则会返回用户的真实数据 | 2023年11月16日 | 不受影响 |
3.FAQ
- 如何判断和识别小程序是否需要进行代码调整?
开发者可以在小程序代码中搜索接口名称进行排查,如有调用记录,请及时调整代码。
- 如果开发者不知道自己的小程序涉及到几个能力接口需要调整怎么办?
开发者可以通过官网客服咨询,提供appid进行查询,当前仅支持查询3个月内的接口调用记录。
- 如开发者账号下涉及多个小程序需要进行代码调整,整改时间不够怎么办?
可以申请延长整改期,开发者可通过此延期申请表单提交需要延期整改的小程序信息,平台将直接为小程序延长整改期,开发者需要在延长整改期前完成代码调整,不支持二次延长整改期,表单提交截止日期为2023年12月16日前。
- 如何知道整改期延长申请是否通过了,平台是否成功给开发者的小程序延长了整改期?
延长期申请表单提交后没有审核反馈(默认通过),如因开发者填写的信息错误或不全导致延长失败,开发者需自行承担能力权限调整导致的影响。在整改期内提交的名单都将统一进行延期处理,即从2023年12月16日延长1个月(最多延长2个月,即延长至2024年2月16日)
- 抖音直播数据(2)和抖音直播数据(3)有什么区别?
从能力名称上均为抖音直播数据,没有区别,因新创建小程序和已创建小程序的接口调用限制时间不同所以进行了序号标记,具体接口权限调整请以接口名称为准,避免容易混淆。