Drive API v2 指南

如果您使用 Google Drive API 版本 2，则 Google Drive API 指南 v3 中的大部分内容也适用于 v2。本部分包含特定于 v2 的所有信息，这些信息不同于 v3 指南的特定页面中显示的信息。如需获取完整上下文，每个子部分都包含指向相应指南页面的链接。

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

下载和发布文件修订版本

在下载和发布文件修订版本页面上，以下信息专门针对 v2，并取代了针对 v3 显示的以下部分：

列出和下载各个修订版本

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

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

自定义文件属性

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

您可以使用 properties 资源访问属性。

这是典型属性的结构，该属性可用于在文件中存储云端硬盘文件的数据库 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 的搜索查询差异

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

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

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