Drive API v2 指南

如果您使用的是 Google 云端硬盘 API 第 2 版，那么 Google 云端硬盘 API 指南第 3 版中的大部分内容也适用于第 2 版。本部分包含所有特定于第 2 版的信息，与第 3 版指南特定页面中显示的内容不同。为了提供完整的背景信息，每个小节都包含指向相应指南页面的链接。

如需查看差异的完整列表，请参阅Drive API 第 2 版和第 3 版比较参考文档。

下载和发布文件修订版本

在“下载和发布文件修订版本 ”页面上，以下信息特定于第 2 版，并替换了为第 3 版显示的这些部分 ：

列出和下载各个修订版本

获取文件修订版本的列表后，您可以通过向其 []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions) 属性发送经过授权的 GET 请求来下载任何修订版本的内容。 Google 云端硬盘会在您请求修订版本时生成此短期网址。 请勿依赖此网址以供日后使用。

您还可以通过检查 exportLinks 属性，以其中一种受支持的格式导出修订版本。

自定义文件属性

除了 添加自定义文件属性 页面上的信息之外，以下信息特定于第 2 版：

属性使用 properties 资源进行访问。

这是典型属性的结构，可用于在文件中存储云端硬盘文件的数据库 ID。

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

如需详细了解限制，请参阅 properties参考文档中的 。

启用共享云端硬盘支持

除了 实现共享云端硬盘支持 页面上的信息之外，请为第 2 版替换此附加字段 trashedDate。

在 实现共享云端硬盘支持 中，以下方法在处理共享云端硬盘内容时需要 supportsAllDrives=true：

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

changes.get 和 changes.list 方法有几个特定于共享云端硬盘的参数。如需查看参数列表，请参阅跟踪共享 云端硬盘 上的更改部分。

上传文件

在上传文件数据页面上，请注意以下 信息特定于第 2 版：

导入到 Google 文档类型

在 Google 云端硬盘中创建文件时，您可以将某些类型的文件转换为 Google 文档、Google 表格或 Google 幻灯片文档。添加 files.insert convert 查询 参数，并设置文件的 (workspace_name) mimeType 属性。如需了解详情，请参阅上传文件 数据。

共享文件、文件夹和云端硬盘

请注意，在共享文件、文件夹和云端硬盘 页面上，在第 3 版中，只有一个字段 role 指定用户、群组 或网域的有效角色。在第 2 版中，您需要同时使用权限的 role 和 additionalRoles 字段来反映用户、群组或网域对给定项拥有的有效角色。

第 2 版的搜索查询差异

第 2 版的 title 字段在第 3 版中为 name。如需查看示例，请参阅搜索文件和 文件夹。

第 2 版的 createdDate 字段在第 3 版中为 createdTime。如需查看示例，请参阅搜索 共享云端硬盘。

第 2 版的 modifiedDate 字段在第 3 版中为 modifiedTime。第 2 版的 lastViewedByMeDate 字段在第 3 版中为 viewedByMeTime。如需了解详情，请参阅搜索查询字词和 运算符。