Drive API v2 指南

如果您使用 Google Drive API 第 2 版，则 Google Drive API 中的大部分内容 指南v3 也与 v2 有关。此部分 包含针对 v2 的所有信息， 如 v3 指南的特定页面中所示。如需获取完整上下文，每个子部分 包含指向相应指南页面的链接。

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

下载和发布文件修订版本

在下载和发布文件修订版本 页面中的“v2”页面，则以下信息是专门针对 v2 的，并取代这些部分 示例：

列表和下载各个修订版本

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

您还可以通过查看 exportLinks 属性。

自定义文件属性

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

使用 properties 资源。

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

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

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

启用共享云端硬盘支持

除实现共享云端硬盘支持页面上的信息外，还请替换这个附加字段 trashedDate（适用于 v2）。

在实现共享云端硬盘支持部分， 与共享库搭配使用时，以下方法需要 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。v2 lastViewedByMeDate 字段为 viewedByMeTime。有关详情，请参阅搜索查询字词和 运算符。