変更とリビジョンの概要

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

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

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

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

共有ドライブの変更ログ

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

変更ログエントリ

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

リビジョン

ファイルの内容(メタデータではない)の変更を表すファイルのバージョン。各リビジョンには、Drive API 内のリビジョン リソースを使用してアクセスできます。

ヘッド リビジョン

ファイルの最新バージョン。

Blob リビジョン

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

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

BLOB リビジョンを「Keep Forever」に設定する方法については、自動削除から保存するリビジョンを指定するをご覧ください。

変更履歴

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