管理文件修订版本

本指南介绍了如何使用 revisions 资源来管理文件修订版本，例如获取文件修订版本和发布 Google Workspace 修订版本。您还可以通过 Google Drive API 下载修订版本。如需详细了解修订版本术语，请参阅更改和修订版本概览。

如需访问修订历史记录，用户必须具有 owner、organizer、fileOrganizer 或 writer 的 role。

如需指定要在响应中返回的字段，您可以使用 revisions 资源的任何方法设置 fields 系统参数。如果您省略此参数，服务器会返回一组默认字段。例如，revisions.list 方法仅返回 id、mimeType、kind 和 modifiedTime 字段。如需返回其他字段，请参阅返回特定字段。

指定要从自动删除中排除的修订版本

Google 云端硬盘会自动删除用户不再需要的旧修订版本。

可以将 blob 文件修订版本设置为“永久保留”，这意味着该修订版本不会被自动清除。最多可将 200 个修订版本设置为“永久保留”，这些版本会占用您的存储空间配额。系统绝不会自动清除头部修订版本。

除了最新修订版本之外，任何未指定为“永久保留”的 blob 文件修订版本都可以清除。可清除的修订版本通常会保留 30 天，但如果某个文件有 100 个未指定为“永久保留”的修订版本，并且上传了新的修订版本，则可清除的修订版本可能会提前清除。

您可以将 revisions 资源的布尔值 keepForever 字段设置为 true，以标记您不希望云端硬盘清除的修订版本。将 blob 文件修订版本设置为“永久保留”后，该版本只能下载或删除。如需了解详情，请参阅下载修订版本或删除修订版本。

如果您使用的是旧版 Drive API v2，请使用 revisions 资源的 pinned 字段，而不是 keepForever。

获取文件修订版本

如需获取文件修订版本的元数据或内容，请对 revisions 资源使用 get 方法，并提供 fileId 和 revisionId 路径参数。如果您不知道修订版本 ID，可以使用 list 方法列出文件中的所有修订版本。

该方法会以 revisions 资源实例的形式返回修订版本的元数据。

如需确认下载已知恶意软件或其他滥用文件的风险，请将 acknowledgeAbuse 查询参数设置为 true。此字段仅在设置了 alt=media 参数且用户是文件所有者或文件所在共享云端硬盘的组织者时适用。

列出文件的修订版本

如需列出文件的修订版本，请对 revisions 资源使用 list 方法，并提供 fileId 路径参数。该方法会返回文件修订版本列表。

传递以下查询参数可自定义修订版本的分页或过滤：

  • pageSize：每页返回的修订版本数上限。

  • pageToken：从之前的列表调用接收的页面令牌。提供此令牌可检索后续页面。

更新文件修订版本

如需更新文件的修订版本，请对 revisions 资源使用 update 方法，并提供 fileId 和 revisionId 路径参数。

该方法会返回 revisions 资源的实例。

下载修订版本

您只能下载标记为“永久保留”的 blob 文件内容修订版本。如果您想下载某个修订版本，请务必先将其设置为“永久保留”。 如需了解详情，请参阅指定要保存的修订版本，以免被自动删除。

如需下载 Blob 文件内容修订版本或导出 Google Workspace 文档内容修订版本，请参阅下载和导出文件。

删除文件修订版本

如需永久删除文件修订版本，请对 revisions 资源使用 delete 方法，并提供 fileId 和 revisionId 路径参数。

您只能删除云端硬盘中包含二进制内容的 blob 文件的修订版本，例如图片、视频和 PDF。当 blob 文件修订版本标记为“永久保留”时，您可以将其删除。其他文件（例如 Google 文档或 Google 表格）的修订版本以及二进制文件的最后一个剩余修订版本无法删除。

发布修订版本

如需发布 Google 文档、Google 表格和 Google 幻灯片修订版本，请在 revisions 资源中为相应文件设置 published 属性。无法使用 Drive API 为 Google 协作平台修订版本设置此属性。

除非设置了 publishAuto 属性，否则已发布的修订版本不会反映对文件所做的更改。如果该属性设置为 true，则系统会自动发布文件的较新修订版本，覆盖之前的版本。Google 幻灯片和绘图仅支持自动重新发布，并且要求将 publishAuto 属性设置为 true。对于 Sites 文件，publishAuto 始终为 false。

如果文件是在 Google Workspace 网域中创建的，则 publishedOutsideDomain 属性会指明相应修订版本是否可供所有人访问，或者是否仅限网域用户访问。对于 Google 协作平台文件，此属性表示是否存在 type=anyone 权限。如需了解详情，请参阅 permissions 资源中的 type 字段。

自动发布还受 Google 文档和 Google 表格界面中的“内容有改动时自动重新发布”复选框控制。如需了解详情，请参阅公开 Google 文档、表格、幻灯片和表单。