如果您使用 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
。如需了解详情,请参阅搜索查询字词和运算符。