変更とリビジョンの概要

Google ドライブでは変更履歴が自動的に保持されるため、ユーザーはファイルの変更やコンテンツの改訂を追跡できます。変更履歴では、どのような編集が行われたかを確認し、特定の編集が加えられた特定のバージョンのファイルに戻すことができます。

Google Drive API の変更リソースとリビジョン リソースに関連する用語は次のとおりです。

アクセス制御リスト（ACL）
ファイル、フォルダ、共有ドライブに関連付けられたすべての権限リソースのリスト。
変更
ファイルまたは共有ドライブのファイル コンテンツまたはメタデータに加えられた変更。
ユーザーの変更ログ

ユーザーがマイドライブ内の編集可能なすべてのファイル（Google ドキュメント、スプレッドシート、スライドなど）に対して行ったすべての変更の記録。共有ドライブのメンバーの場合、ユーザーの変更ログには、共有ドライブのメンバーシップ、その共有ドライブ内のアイテムに対するユーザーのアクセスレベル、共有ドライブ名の変更に関するエントリも含まれます。

共有ドライブの変更ログ

ユーザーの追加や削除など、共有ドライブに対するすべての変更と、その共有ドライブ上のアイテムに対するすべての変更の記録。共有ドライブ内のアイテムに対する変更は、ユーザーの変更ログと共有ドライブの変更ログの両方に表示されます。

変更ログエントリ

ファイルまたは共有ドライブのファイル コンテンツまたはメタデータに加えられた変更の記録。変更ログエントリには、変更を行ったユーザー、タイムスタンプ、ID が示されます。変更ログには、ファイルまたは共有ドライブごとに 1 つのエントリのみを含めることができます。ファイルまたは共有ドライブが変更されるたびに、そのエントリに新しい ID が作成され、以前のエントリが置き換えられます。

リビジョン

ファイルのコンテンツ（メタデータではない）の変更を表すファイルのバージョン。各リビジョンには、ドライブ API 内の revisions リソースを使用してアクセスできます。

ヘッド リビジョン

ファイルの最新バージョン。headRevisionId には、 Drive API 内の files リソースを使用してアクセスできます。headRevisionId は、ドライブ内の blob ファイルでのみ使用できます。

blob リビジョン

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

ヘッド リビジョン以外の blob ファイルのリビジョンで、「永久保存」に指定されていないものは削除できます。削除可能なリビジョンは通常 30 日間保持されますが、ファイルに「永久保存」に指定されていないリビジョンが 100 個あり、新しいリビジョンがアップロードされた場合は、それより前に削除されることがあります。

blob リビジョンを "永久保存" に設定する方法について詳しくは、 自動削除から保存するリビジョンを指定するをご覧ください。

変更履歴

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