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}