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。

启用共享云端硬盘支持

除了实现共享云端硬盘支持页面上的信息之外，请将此附加字段 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 的搜索查询差异

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

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

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