下载和发布文件修订版本

Google Drive API 提供了 Revisions 资源,以便您下载和发布文件修订版本。如需详细了解修订版本术语,请参阅变更和修订版本概览

指定要在自动删除中保存的修订版本

Google 云端硬盘会自动删除用户不再感兴趣的旧版本。为防止出现这种情况,您可以将布尔标志 keepRevisionForever 设为 true,以标记您不想让云端硬盘完全清除的修订版本。

下载修订版本

您可以使用 Files 资源中的 headRevisionId 字段的值来下载最新修订版本。 这会提取与您之前检索到的文件元数据对应的修订版本。如要下载仍存储在云端的文件所有先前修订版本的数据,您可以调用 revisions.list 来获取所有修订版本 ID。

要下载修订版本内容,您需要调用 带有参数 alt=mediarevisions.get 方法。无法下载 Google 文档、表格和幻灯片的修订版本。

Google 文档、Google 绘图和幻灯片的修订版本号会自动递增。但是,如果删除修订版本,则系列编号可能出现间断,因此在检索修订版本时不应依赖序列号。

发布修订版本

要发布 Google 文档、表格和幻灯片修订版本,请在 Revisions 属性中为该文件设置 published 属性。您无法通过 Drive API 为 Google 协作平台修订版本设置此属性。

如果文件是在 Google Workspace 网域中创建的, publishedOutsideDomain 属性指示修订版本是否 或者是否仅限网域内用户使用。对于 Google 协作平台文件,此属性指示是否存在 type=anyone 权限。

除非设置了 publishAuto 属性,否则已发布的修订版本不会反映对文件所做的更改。如果该属性设置为 true,则文件的较新版本将自动发布,覆盖之前的修订版本。此行为也可通过“内容有改动时自动重新发布”来控制复选框。对于 Google 协作平台文件,publishAuto 始终为 false