云端硬盘 Android API 已于 2018 年 12 月 6 日被废弃,并将于 2023 年 2 月 1 日全面停用 。
时间轴
| 日期 | 云端硬盘 Android API 状态 |
|---|---|
| 2018 年 12 月 6 日 | 公开宣布废弃。现有客户端将能够 正常访问该 API,但应立即开始迁移 工作。新客户端不得使用该 API。 |
| 2019 年 10 月 21 日 | 云端硬盘 Android API 已从 Google Play 服务 SDK 分发中移除。在移除云端硬盘 Android API 依赖项之前,应用将无法构建,但现有构建不受影响。云端硬盘 Android API 公开文档将不再提供。 |
| 2022 年 3 月 3 日 | 云端硬盘 Android API 已被废弃,所有 API 调用均无法运行。客户端必须在此日期之前完成迁移。 |
| 2023 年 2 月 1 日 | 云端硬盘 Android API 将全面停用,所有连接尝试都将失败。 |
使用云端硬盘 REST API
云端硬盘 REST API 提供与云端硬盘 Android API 相同的功能,包括以下方式:
- 按照您对云端硬盘的预期方式进行共享和协作。您可以 根据需要管理权限或向用户显示“共享”对话框 。REST API 还允许对文件添加评论,让您的应用能够与围绕文件的对话进行交互。
- 使用
files.list, 根据传统索引或 您自己的自定义可索引文本搜索文件。 - 通过 “更改”集合检测文件更改,并通过 共享云端硬盘检测与用户共享的任何文件更改。
- 导出和转换 Google 文档,以便您的应用能够轻松 打开用户的文档。
为了方便客户端迁移,我们提供了一个 示例应用,其中 演示了上述每个建议的替换项。它还展示了如何使用 REST API 创建、修改和查询用户的云端硬盘文件。如果您 遇到任何问题,请查看 StackOverflow 上的 google-drive-api 标记。
迁移
由于云端硬盘 Android API 已被废弃,所有 API 调用均无法运行,因此请确保您的应用不再调用该 API。为此,请移除初始化该 API 的代码:addApi(Drive.API)。
如果您不从云端硬盘 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}