Google Drive API 提供 revisions 资源，以便您下载和发布文件修订版本。如需详细了解修订版本术语，请参阅变更和修订版本概览。
本指南介绍了如何使用 Google Drive API 管理文件修订版本。
指定要从自动删除中排除的修订版本
Google 云端硬盘会自动删除用户不再需要的旧修订版本。
可以将 blob 文件修订版本设置为“永久保留”，这意味着该修订版本不会被自动清除。最多可将 200 个修订版本设置为“永久保留”，这些版本会占用您的存储空间配额。系统绝不会自动清除头部修订版本。
除了最新修订版本之外，任何未指定为“永久保留”的 blob 文件修订版本都可以清除。可清除的修订版本通常会保留 30 天，但如果某个文件有 100 个未指定为“永久保留”的修订版本，并且上传了新的修订版本，则可清除的修订版本可能会提前清除。
您可以将 revisions 资源的布尔值 keepForever 字段设置为 true，以标记您不希望云端硬盘清除的修订版本。将 blob 文件修订版本设置为“永久保留”后，该版本只能下载或删除。如需了解详情，请参阅下载修订版本或删除修订版本。
下载修订版本
您只能下载标记为“永久保留”的 blob 文件内容修订版本。如果您想下载某个修订版本，请务必先将其设置为“永久保留”。 如需了解详情，请参阅指定要保存的修订版本，以免被自动删除。
如需下载 Blob 文件内容修订版本或导出 Google Workspace 文档内容修订版本，请参阅下载和导出文件。
删除修订版本
您可以调用 revisions.delete 方法来永久删除 Blob 文件修订版本，即使该版本被标记为“永久保留”也是如此。
如果您使用的是旧版 Drive API v2，请改用 revisions 资源的 pinned 字段。
发布修订版本
如需发布 Google 文档、Google 表格和 Google 幻灯片修订版本，请在 revisions 资源中为相应文件设置 published 属性。无法使用 Drive API 为 Google 协作平台修订版本设置此属性。
Google 幻灯片和 Google 绘图不支持发布特定修订版本。仅支持自动重新发布最新修订版本。如需发布 Google 幻灯片和绘图，请将 publishAuto 也设置为 true。
如果文件是在 Google Workspace 网域中创建的，则 publishedOutsideDomain 属性会指明相应修订版本是否可供所有人访问，或者是否仅限网域用户访问。对于 Google 协作平台文件，此属性表示是否存在 type=anyone 权限。如需了解详情，请参阅 permissions 资源中的 type 字段。
除非设置了 publishAuto 属性，否则已发布的修订版本不会反映对文件所做的更改。如果该属性设置为 true，则系统会自动发布文件的较新修订版本，覆盖之前的版本。Google 幻灯片和绘图仅支持自动重新发布，并且要求将 publishAuto 属性设置为 true。对于 Sites 文件，publishAuto 始终为 false。
自动发布还受 Google 文档和 Google 表格界面中的“内容有改动时自动重新发布”复选框控制。如需了解详情，请参阅公开 Google 文档、表格、幻灯片和表单。