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}