变更和修订版本概览

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

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

访问控制列表 (ACL)
与文件、文件夹或共享云端硬盘关联的所有权限资源的列表。
更改
对文件内容或文件或共享云端硬盘的元数据所做的更改。
用户更新日志

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

共享云端硬盘更新日志

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

更新日志条目

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

修订版本

表示对文件内容（而非元数据）所做的更改的文件版本。可以使用 Drive API 中的 revisions 资源访问每个修订版本。

最新修订版本

文件的最新版本。可以使用 Drive API 中的files 资源访问 headRevisionId。headRevisionId 仅适用于云端硬盘中的 Blob 文件。

Blob 修订版本

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

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

如需详细了解如何将 Blob 修订版本设置为 "永久保留"，请参阅 指定要保留的修订版本，以防自动 删除。

修订历史记录

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