云端硬盘 Android API 自 2018 年 12 月 6 日起已弃用,并将于 2023 年 2 月 1 日完全停用。
时间轴
日期 | Drive Android API 状态 |
---|---|
2018 年 12 月 6 日 | 弃用会公开发布。现有客户端将能够正常访问该 API,但应立即开始迁移工作。新客户不得使用该 API。 |
2019 年 10 月 21 日 | 已从 Google Play 服务 SDK 分发中移除 Drive Android API。在移除 Drive Android API 依赖项之前,应用将无法构建,但现有 build 不会受到影响。Drive Android API 公开文档将不再提供。 |
2022 年 3 月 3 日 | 云端硬盘 Android API 已被废弃,所有 API 调用均无法运行。客户必须在此日期之前完成迁移。 |
2023 年 2 月 1 日 | 云端硬盘 Android API 将完全停用,所有连接尝试都将失败。 |
使用 Drive REST API
云端硬盘 REST API 提供与云端硬盘 Android API 相同的功能,包括以下操作:
- 像在云端硬盘中一样进行共享和协作。您可以根据需要管理权限或向用户显示“共享”对话框。REST API 还允许对文件添加注释,从而使您的应用能够与围绕文件的对话进行互动。
- 使用
files.list
搜索文件,搜索依据可以是传统索引,也可以是您自己自定义的可编入索引的文本。 - 通过更改集合检测文件的更改,并通过共享云端硬盘检测与用户共享的任何内容的更改。
- 导出和转换 Google 文档,以便您的应用能够轻松打开用户文档。
为了方便客户端迁移,我们提供了一个示例应用,其中演示了上述每项建议的替换。此外,它还展示了如何使用 REST API 创建、修改和查询用户的云端硬盘文件。如果您遇到任何问题,请查看 StackOverflow 上的 google-drive-api 标记。
迁移
由于 Drive Android API 已弃用,并且所有 API 调用均无法运行,请确保您的应用不再调用该 API。为此,请移除初始化 API 的代码:addApi(Drive.API)
。
如果您不从 Drive Android API 迁移,并且您的应用尝试调用该 API,系统会返回以下错误消息:
com.google.android.gms.common.api.ApiException: 17: API: Drive.API is not
available on this device. Connection failed with:
ConnectionResult{statusCode=API_UNAVAILABLE, resolution=null, message=null}