ファイルの版をダウンロードして公開する

Google Drive API には Revisions リソースがあり、ファイルのリビジョンをダウンロードして公開できます。リビジョンの用語について詳しくは、変更とリビジョンの概要をご覧ください。

自動削除から保存するリビジョンを指定する

Google ドライブは、ユーザーが不要になった古いリビジョンを自動的に削除されます。これを防ぐには、ブール値フラグ keepRevisionForevertrue に設定して、ドライブでパージしたくないリビジョンにマークを付けます。

リビジョンをダウンロードする

Files リソースの headRevisionId フィールドの値を使用して、最新のリビジョンをダウンロードできます。 これにより、以前に取得したファイルのメタデータに対応するリビジョンが取得されます。クラウドにまだ保存されているファイルの以前のすべてのリビジョンのデータをダウンロードするには、revisions.list を呼び出してすべての revisionId を取得します。

リビジョン コンテンツをダウンロードするには、 パラメータ alt=media を持つ revisions.get メソッド。Google ドキュメント、スプレッドシート、スライドの変更内容はダウンロードできません。

Google ドキュメント、Google 図形描画、スライドのリビジョンでは、リビジョン番号が自動的にインクリメントされます。ただし、リビジョンが削除されると、一連の番号にギャップが生じる可能性があるため、リビジョンを取得するときは連続した番号を使用しないでください。

リビジョンを公開する

Google ドキュメント、スプレッドシート、スライドのリビジョンを公開するには、そのファイルの published プロパティを [Revisions] プロパティに設定します。このプロパティは、Drive API を使用して Google サイトのリビジョンには設定できません。

ファイルがドメインで Google Workspace 作成されている場合は、 publishedOutsideDomain プロパティは、リビジョンが 誰でも、またはドメインのユーザー限定でアクセスできます。Google Google サイトファイルの場合、このプロパティは type=anyone 権限が存在するかどうかを示します。

publishAuto プロパティが設定されていない限り、公開済みのリビジョンにはファイルに加えられた変更は反映されません。このプロパティを true に設定した場合、ファイルの新しい版が自動的に公開され、以前の版が上書きされます。この動作は、[変更が加えられたら自動的に再公開する]チェックボックスが表示されます。Google サイトのファイルの場合、publishAuto は常に false です。