Drive API v2 指南

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

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

下载和发布文件修订版本

下载和发布文件修订版本页面上,以下信息仅适用于 v2,并替换了针对 v3 显示的这些部分:

列出和下载各个修订版本

获取文件的修订版本列表后,您可以将已获授权的 GET 请求发送到其 []downloadUrl](/drive/api/reference/rest/v2/revisions) 属性,以下载任何修订版本的内容。当您请求修订版本时,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.getchanges.list 方法有多个特定于共享云端硬盘的参数。如需查看参数列表,请参阅跟踪共享云端硬盘的更改部分。

上传文件

上传文件数据页面上,请注意以下信息仅适用于 v2:

导入到 Google 文档类型

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

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

请注意,在共享文件、文件夹和驱动器页面上,在 v3 中,只有一个字段 role 为用户、群组或网域指定了有效角色。在 v2 中,您需要权限的 roleadditionalRoles 字段反映用户、群组或网域对给定项的有效角色。

v2 的搜索查询差异

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

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

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