Google Drive API 提供了 Revisions 资源,以便您下载和发布文件修订版本。如需详细了解修订版本术语,请参阅变更和修订版本概览。
指定要在自动删除中保存的修订版本
Google 云端硬盘会自动删除用户不再感兴趣的旧版本。为防止出现这种情况,您可以将布尔标志 keepRevisionForever
设为 true
,以标记您不想让云端硬盘完全清除的修订版本。
下载修订版本
您可以使用 Files 资源中的 headRevisionId
字段的值来下载最新修订版本。
这会提取与您之前检索到的文件元数据对应的修订版本。如要下载仍存储在云端的文件所有先前修订版本的数据,您可以调用 revisions.list
来获取所有修订版本 ID。
要下载修订版本内容,您需要调用
带有参数 alt=media
的 revisions.get
方法。无法下载 Google 文档、表格和幻灯片的修订版本。
Google 文档、Google 绘图和幻灯片的修订版本号会自动递增。但是,如果删除修订版本,则系列编号可能出现间断,因此在检索修订版本时不应依赖序列号。
发布修订版本
要发布 Google 文档、表格和幻灯片修订版本,请在 Revisions 属性中为该文件设置 published
属性。您无法通过 Drive API 为 Google 协作平台修订版本设置此属性。
如果文件是在 网域中创建的,
publishedOutsideDomain
属性指示修订版本是否
或者是否仅限网域内用户使用。对于 Google
协作平台文件,此属性指示是否存在 type=anyone
权限。
除非设置了 publishAuto
属性,否则已发布的修订版本不会反映对文件所做的更改。如果该属性设置为 true,则文件的较新版本将自动发布,覆盖之前的修订版本。此行为也可通过“内容有改动时自动重新发布”来控制复选框。对于 Google 协作平台文件,publishAuto
始终为 false
。