变更和修订版本概览

Google 云端硬盘会自动维护修改记录，这有助于用户跟踪文件更改和内容修订。在修订历史记录中，用户可以查看所做的修改，还可以还原到包含特定修改的文件的特定版本。

以下术语与 Google Drive API 的更改和修订资源相关：

访问控制列表 (ACL)

与文件、文件夹或共享云端硬盘关联的所有权限资源的列表。

更改

对文件内容或文件或共享云端硬盘的元数据所做的更改。

用户更改日志

记录用户对“我的云端硬盘”中每个可编辑文件（例如 Google 文档、表格或幻灯片）所做的所有更改。对于共享云端硬盘的成员，用户更改日志还包含与共享云端硬盘成员资格、用户对共享云端硬盘中内容的访问权限级别以及共享云端硬盘名称更改相关的条目。

注意： 即使有多个用户可以访问同一文件，但并非该文件的所有更改都会反映在每个用户的更新日志中。例如，当用户首次打开文件或将文件标记为“已收藏”时，这些更改只会显示在该用户的更改日志中。再举一个例子，当文件的 ACL 发生更改时，更改只会反映在以下用户的更新日志中：文件的所有者、ACL 中的任何服务账号，以及受 ACL 更改直接影响的任何用户。

共享云端硬盘更新日志

记录了对共享云端硬盘所做的所有更改，例如添加或移除用户，以及对该共享云端硬盘中内容所做的所有更改。对共享云端硬盘中内容所做的更改会同时显示在用户更改日志和共享云端硬盘更改日志中。

更新日志条目

对文件内容或文件或共享云端硬盘的元数据所做的更改的记录。更改日志条目会指明进行更改的用户、时间戳和 ID。更改日志中一次只能包含每个文件或共享云端硬盘的一个条目。每当相应文件或共享云端硬盘发生更改时，系统都会为该条目创建一个新 ID，并将其替换为之前的条目。

修订版本

文件的版本，表示文件内容（而非元数据）发生了更改。您可以使用 Drive API 中的 Revision 资源访问每个修订版本。

主修订版本

文件的最新版本。

Blob 修订版本

不可修改的二进制文件（例如图片、视频或 PDF 文件）的版本。 如果 blob 修订版本是二进制文件的唯一修订版本，则无法删除该 blob 修订版本。您可以将新的 blob 作为新修订版本上传，该修订版本将成为该文件的新主修订版本。

您可以将 blob 修订版本设置为“永久保留”，这意味着系统无法自动清除该修订版本。最多可以将 200 个修订版本设为“永久保留”。主修订版绝不会自动清除。

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

Revisions 资源的 keepForever 字段用于将修订版本设置为“永久保留”。此外，您可以调用 revisions.delete 来删除修订版，即使其已标记为“永久保留”也是如此。

注意 ：如果您使用的是旧版 Drive API v2，请改用 Revisions 资源的 pinned 字段。

修订历史记录

按时间顺序记录文件的所有修订版本。对文档、表格或幻灯片文件所做的更改会生成新的修订版本。每次内容发生变化时，云端硬盘都会为该文件创建新的修订历史记录条目。不过，这些编辑器文件修订版本可能会合并在一起，因此 API 响应可能不会显示对文件的所有更改。

观看此视频，了解如何使用 Google 云端硬盘 API 管理修订版本：

后续步骤

• 如需确定要跟踪的更改的记录位置，请参阅确定要跟踪的更改日志。
• 如需为用户和共享云端硬盘设置更改跟踪，请参阅跟踪用户和共享云端硬盘的更改。
• 如需发布、下载或查询修订版本，请参阅下载和发布文件修订版本。
• 如需设置更改通知，请参阅推送通知。