变更和修订版本概览

Google 云端硬盘会自动保存修改历史记录 用户可跟踪文件更改和内容修订。在修订历史记录中 可以查看所做的修改,并且可以还原为文件的特定版本 进行特定的修改

以下术语与 Google Drive API:

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

不可修改的二进制文件的版本,例如图片、视频或 PDF。 如果 Blob 修订版本是二进制文件的唯一修订版本,它不能是 已删除。新 blob 可以作为新修订版本上传,而该修订版本就会成为新的 该文件的头修订版本

Blob 修订版本可以设置为“永久保留”这表示 已自动清除最多可以将 200 个修订版本设置为“永久保留”。通过 版本永远不会被自动清除。

除头部修订版本之外的任何未指定为“保留”的修订版本 永久”是可清除的可完全清除的修订版本通常会保留 30 天,但如果文件包含 100 个非 指定为“永久保留”并上传新的修订版本

RevisionskeepForever 字段 资源用于将修订版本设置为“永久保留”。此外,您还可以 调用 revisions.delete 来删除 即使该修订版本已标记为“永久保留”。

修订历史记录

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

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

后续步骤