変更とリビジョンの概要

Google ドライブでは変更の履歴が自動的に維持されるため、ユーザーはファイルの変更とコンテンツのリビジョンを追跡できます。変更履歴で、ユーザーは行われた編集を確認し、特定の編集を行ったファイルの特定のバージョンに戻すことができます。

次の用語は、Google Drive API の変更とリビジョンのリソースに関連しています。

アクセス制御リスト（ACL）
ファイル、フォルダ、または共有ドライブに関連付けられているすべての権限リソースのリスト。
変更
ファイルまたは共有ドライブのコンテンツやメタデータに変更が加えられた。
ユーザーの変更履歴
マイドライブ内の編集可能なファイル（Google ドキュメント、スプレッドシート、スライドなど）に対してユーザーが行ったすべての変更の記録。共有ドライブのメンバーについては、ユーザー変更ログには、共有ドライブのメンバーシップ、その共有ドライブ内のアイテムに対するユーザー アクセスレベル、共有ドライブ名の変更に関するエントリも含まれます。
共有ドライブの変更履歴
ユーザーの追加や削除、その共有ドライブ上のアイテムに対するすべての変更など、共有ドライブに対するすべての変更の記録。共有ドライブ内のアイテムに対する変更は、ユーザー変更ログと共有ドライブ変更ログの両方に表示されます。
変更ログエントリ
ファイルまたは共有ドライブのコンテンツやメタデータに加えられた変更の記録。変更ログエントリには、変更を行ったユーザー、タイムスタンプ、ID が表示されます。変更ログのエントリは、ファイルまたは共有ドライブごとに 1 つだけです。そのファイルまたは共有ドライブが変更されるたびに、そのエントリに新しい ID が作成され、以前のエントリは置き換えられます。
リビジョン
ファイルの内容（メタデータではない）の変更を表すファイルのバージョン。各リビジョンには、Drive API 内のリビジョン リソースを使用してアクセスできます。
ヘッドリビジョン
ファイルの最新バージョン。
Blob のリビジョン

画像、動画、PDF など、変更できないバイナリ ファイルのバージョン。blob リビジョンがバイナリ ファイルの唯一のリビジョンである場合、そのリビジョンは削除できません。新しい blob を新しいリビジョンとしてアップロードすると、そのファイルの新しいヘッド リビジョンになります。

Blob リビジョンは、リビジョンを自動的にパージできない「Keep Forever」に設定できます。最大 200 件のリビジョンを [この履歴に保存] に設定できます。ヘッド リビジョンは自動的にパージされません。

ヘッド リビジョンを除き、「Keep Forever」として指定されていないリビジョンはパージ可能です。通常、パージ可能なリビジョンは 30 日間保持されますが、「永久保存」に指定されていないリビジョンが 100 個あり、新しいリビジョンがアップロードされている場合は、それより早くパージできます。

Revisions リソースの keepForever フィールドは、リビジョンを [Keep Forever] に設定するために使用されます。また、revisions.delete を呼び出すと、リビジョンが「この履歴を削除しない」になっていても、リビジョンを削除できます。

変更履歴

ファイルのすべてのリビジョンの時系列の記録。ドキュメント、スプレッドシート、スライドのファイルに加えた変更が新しいリビジョンになります。コンテンツが変更されるたびに、ドライブはそのファイルの新しい変更履歴エントリを作成します。ただし、これらのエディタ ファイルのリビジョンはマージされる場合があるため、API レスポンスではファイルに対するすべての変更が表示されないことがあります。

Google Drive API を使用してリビジョンを管理する方法については、次の動画をご覧ください。

次のステップ