Drive API v2 指南

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

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

下载和发布文件修订版本

在下载和发布文件修订版本页面上，以下信息是 v2 特有的，会替换 v3 中显示的相应部分：

列出和下载各个修订版本

获取文件修订版本的列表后，您可以向任何修订版本的 GET 属性发送经过授权的 downloadUrl 请求，下载相应修订版本的内容。当您请求修订版本时，Google 云端硬盘会生成此短期有效网址。 请勿依赖此分析以供日后使用。

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

自定义文件属性

除了添加自定义文件属性页面上的信息之外，以下信息是 v2 特有的：

属性通过 properties 资源进行访问。

以下是一个典型属性的结构，该属性可能用于在文件上存储 Drive 文件的数据库 ID。

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

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

启用共享云端硬盘支持

除了实现共享云端硬盘支持页面上的信息之外，请替换 v2 的这个额外字段 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 方法有多个特定于共享云端硬盘的参数。如需查看参数列表，请参阅跟踪共享云端硬盘中的更改部分。

上传文件

在上传文件数据页面上，请注意以下信息是 v2 特有的：

可导入到 Google 文档的文件类型

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

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

请注意，在共享文件、文件夹和云端硬盘页面上，在 v3 中，只有一个字段 role 用于指定用户、群组或网域的有效角色。在 v2 中，权限的 role 和 additionalRoles 字段都需要反映用户、群组或网域对给定商品的有效角色。

v2 的搜索查询差异

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

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

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