下载和发布文件修订版本

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

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

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

下载修订版本

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

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

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

发布修订版本

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

如果文件是在 Google Workspace 网域中创建的,则 publishedOutsideDomain 属性会指示修订版本是否可供任何人访问,或者是否仅限该网域中的用户访问。对于 Google 协作平台文件,此属性指示是否存在 type=anyone 权限。

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