Google Drive API には Revisions リソースがあり、ファイルのリビジョンをダウンロードして公開できます。リビジョンの用語について詳しくは、変更とリビジョンの概要をご覧ください。
自動削除から保存するリビジョンを指定する
Google ドライブは、ユーザーが不要になった古いリビジョンを自動的に削除されます。これを防ぐには、ブール値フラグ keepRevisionForever
を true
に設定して、ドライブでパージしたくないリビジョンにマークを付けます。
リビジョンをダウンロードする
Files リソースの headRevisionId
フィールドの値を使用して、最新のリビジョンをダウンロードできます。
これにより、以前に取得したファイルのメタデータに対応するリビジョンが取得されます。クラウドにまだ保存されているファイルの以前のすべてのリビジョンのデータをダウンロードするには、revisions.list
を呼び出してすべてのリビジョン ID を取得します。
リビジョン コンテンツをダウンロードするには、
パラメータ 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
です。