Drive Android API 自 2018 年 12 月 6 日起弃用,并将于 2023 年 2 月 1 日完全停用。
时间表
日期 | 云端硬盘 Android API 状态 |
---|---|
2018 年 12 月 6 日 | 弃用会公布。现有客户将能够正常访问该 API,但应立即开始进行迁移。新客户端不得使用该 API。 |
2019 年 10 月 21 日 | Drive Android API 已从 Google Play 服务 SDK 发行版中移除。在移除 Drive Android API 依赖项之前,应用无法构建,但现有 build 不会受到影响。Drive Android API 公开文档将不再提供。 |
2022 年 3 月 3 日 | Drive Android API 已弃用,所有 API 调用均无法正常运行。客户端必须在此日期之前完成迁移。 |
2023 年 2 月 1 日 | Drive Android API 将完全停用,所有连接尝试都将失败。 |
使用 Drive REST API
Drive REST API 提供与 Drive 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}