变更和修订版本概览

Google 云端硬盘会保留修改的自动历史记录,这有助于用户跟踪文件更改和内容修订。在修订历史记录中,用户可以查看已经进行的修改,还可以还原到包含具体修改的文件的特定版本。

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

访问控制列表 (ACL)
与文件、文件夹或共享云端硬盘关联的所有权限资源的列表。
更改
对文件的内容或者文件或共享云端硬盘的元数据进行的修改。
用户更新日志
用户对其“我的云端硬盘”中的每个可编辑文件(例如 Google 文档、表格或幻灯片)进行的所有更改的记录。对于共享云端硬盘的成员,用户更改日志还包含有关共享云端硬盘成员资格、用户对共享云端硬盘中内容的访问权限级别以及共享云端硬盘名称更改的条目。
共享云端硬盘更新日志
对共享云端硬盘进行的所有更改(例如添加或移除用户)以及对共享云端硬盘中的内容所做的所有更改的记录。对共享云端硬盘中某项内容所做的更改会同时反映在用户更新日志和共享云端硬盘更新日志中。
更改日志条目
对文件的内容或文件或共享云端硬盘的元数据所做的更改的记录。变更日志条目会指明进行更改的用户、时间戳和 ID。在更新日志中,每个文件或共享云端硬盘一次只能有一个条目。每当该文件或共享云端硬盘发生更改时,系统都会为该条目创建一个新 ID,并替换之前的条目。
修订版本
文件的一个版本,表示文件内容(而非元数据)的更改。您可以使用 Drive API 中的 Revision 资源访问每个修订版本。
标题修订版本
文件的最新版本。
Blob 修订版本

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

您可以将 Blob 修订版本设置为“永久保留”,这意味着系统不会自动完全清除该修订版本。您最多可将“永久保留”设置为 200 个修订版本。系统永远不会自动清除头部修订版本。

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

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

修订历史记录

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

观看此视频,了解如何使用 Google Drive API 管理修订版本:

后续步骤