变更和修订版本概览

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

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

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

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

共享云端硬盘变更日志

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

变更日志条目

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

修订版本

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

最新修订版本

文件的最新版本。

Blob 修订版本

不可修改的二进制文件(例如图片、视频或 PDF)的版本。如果 blob 修订版本是二进制文件的唯一修订版本,则无法删除。您可以将新 blob 上传为新修订版本,该版本将成为相应文件的新头部修订版本。

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

如需详细了解如何将 Blob 修订版本设置为“永久保留”,请参阅指定要从自动删除中保存的修订版本

修订历史记录

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