変更とリビジョンの概要

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 を呼び出すと、リビジョンが「Keep Forever」とマークされている場合でも削除できます。

変更履歴

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

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

次のステップ