Google Drive API は、ファイル リビジョンをダウンロードして公開できるように、revisions リソースを提供します。リビジョンの用語の詳細については、変更とリビジョンの概要をご覧ください。
このガイドでは、Google Drive API を使用してファイル リビジョンを管理する方法について説明します。
自動削除から保存するリビジョンを指定する
Google ドライブでは、ユーザーが関心を持たなくなった古いリビジョンは自動的に削除されます。
blob ファイル リビジョンを「Keep Forever」に設定すると、リビジョンが自動的に削除されなくなります。「永久に保存」に設定できる版は 200 個までで、保存容量にカウントされます。ヘッド リビジョンが自動的に削除されることはありません。
ヘッド リビジョン以外の「この履歴を削除しない」に指定されていないすべての BLOB ファイル リビジョンは削除できます。削除可能なリビジョンは通常 30 日間保持されますが、ファイルに「永久保存」に指定されていないリビジョンが 100 個あり、新しいリビジョンがアップロードされた場合は、それより早く削除されることがあります。
revisions リソースのブール値 keepForever フィールドを true に設定して、ドライブで削除しないリビジョンをマークできます。BLOB ファイルのリビジョンが [Keep Forever] に設定されると、ダウンロードまたは削除のみが可能になります。詳細については、リビジョンをダウンロードするまたはリビジョンを削除するをご覧ください。
リビジョンをダウンロードする
「この履歴を削除しない」とマークされた blob ファイル コンテンツの改訂版のみをダウンロードできます。リビジョンをダウンロードする場合は、まず [この履歴を削除しない] に設定してください。詳細については、自動削除から保存するリビジョンを指定するをご覧ください。
BLOB ファイルのコンテンツ リビジョンをダウンロードする、または Google Workspace ドキュメントのコンテンツ リビジョンをエクスポートするには、ファイルのダウンロードとエクスポートをご覧ください。
リビジョンを削除する
「この履歴を削除しない」とマークされている場合でも、revisions.delete メソッドを呼び出して、BLOB ファイルの版を完全に削除できます。
古い Drive API v2 を使用している場合は、代わりに revisions リソースの pinned フィールドを使用します。
リビジョンを公開する
Google ドキュメント、Google スプレッドシート、Google スライドの改訂版を公開するには、revisions リソースでそのファイルの published プロパティを設定します。このプロパティは、Drive API を使用して Google サイトのリビジョンに設定することはできません。
Google スライドと Google 図形描画では、特定のリビジョンの公開はサポートされていません。最新のリビジョンの自動再公開のみがサポートされています。スライドと図形描画を公開するには、publishAuto を true に設定します。
ファイルが Google Workspace ドメインで作成された場合、publishedOutsideDomain プロパティは、リビジョンに誰でもアクセスできるか、ドメインのユーザーに制限されているかを示します。サイト ファイルの場合、このプロパティは type=anyone 権限が存在するかどうかを示します。詳細については、permissions リソースの type フィールドをご覧ください。
publishAuto プロパティが設定されていない限り、公開されたリビジョンにはファイルに加えられた変更が反映されません。プロパティが true に設定されている場合、ファイルの新しいリビジョンが自動的に公開され、以前のリビジョンが上書きされます。スライドと図形では自動再公開のみがサポートされており、publishAuto プロパティを true に設定する必要があります。Sites ファイルの場合、publishAuto は常に false です。
自動公開は、ドキュメントとスプレッドシートの UI にある [変更が加えられると自動的に再公開する] チェックボックスでも制御できます。詳しくは、Google ドキュメント、スプレッドシート、スライド、フォームを公開するをご覧ください。