Drive 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。在移除云端硬盘 Android API 依赖项之前,应用将无法构建,但现有 build 不会受到影响。Drive Android API 公开文档将不再可用。 |
2022 年 3 月 3 日 | Drive Android API 已废弃,所有 API 调用都无法运行。客户必须在该日期之前完成迁移。 |
2023 年 2 月 1 日 | 云端硬盘 Android API 将被完全停用,所有连接尝试都将失败。 |
使用 Drive REST API
Drive REST API 提供与 Drive Android API 相同的功能,包括:
- 您可以像使用云端硬盘一样进行共享和协作。您可以根据需要管理权限或向用户显示“分享”对话框。REST API 还支持对文件添加评论,让您的应用能够与文件相关的对话进行互动。
- 使用
files.list
搜索文件,基于传统索引或您自己自定义的可编入索引的文本。 - 通过 Changes 集合检测文件的更改,以及通过共享云端硬盘与用户共享的任何内容的更改。
- 导出和转换 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}