Google ドライブ アプリがドライブ内のアイテムに対する変更を追跡する必要がある場合、変更コレクションを使用すると、変更を効率的に検出できます。このコレクションは、特定の時点以降にアイテムが変更された場合にのみ、各アイテムの現在の状態を提供します。
Google ドライブでは、ユーザーと共有ドライブごとに変更履歴が保存されます。各アイテムには、関心のあるアイテムに対する変更が独自に記録されています。
ユーザーに表示されるすべてのアイテムの変更を追跡するには、ユーザーがメンバーになっているすべての共有ドライブについて、ユーザー変更ログと変更ログの両方を再生する必要があります。
変更エントリを有効にする
変更エントリは、特定の時点におけるファイルまたは共有ドライブの状態を表します。変更によってリビジョン間の差分が生じることはありません。プロパティの変更を把握する必要があるアプリケーションでは、以前に認識されているアイテムの状態を保持して比較する必要があります。
変更はアイテムの現在の状態を表すため、個々の変更エントリが無効になり、対応するアイテムの新しい変更エントリで置き換えられる場合があります。
トゥームストーン
ユーザーが使用できなくなったアイテムの変更エントリは、その変更エントリ内で deleted とマークされます。変更エントリで使用できるのはアイテムの ID のみです。
共有ドライブの追跡
共有ドライブごとに固有の変更ログが記録されます。ユーザーが共有ドライブのメンバーであっても、一部の変更は共有ドライブの変更履歴にのみ反映され、ユーザーの変更履歴には反映されません。ファイルが共有ドライブに属する場合、そのファイルが過去のある時点でユーザーの変更ログにまだ表示されていても、ユーザーの変更ログを再生するだけではファイルのステータスが正しく更新されません。代わりに、共有ドライブの変更ログをリプレイして、すべての変更をキャプチャする必要があります。
ユーザーの変更履歴の内容
ユーザーの変更ログには、ユーザーがメンバーである共有ドライブに対する変更と、ユーザーのコーパス内のファイルに対する変更が含まれます。コーパスの詳細については、変更とリビジョンの概要をご覧ください。
共有ドライブに関する以下の変更は、ユーザーの変更履歴に表示されます。
- ユーザーが共有ドライブのメンバーになる。
- ユーザーが共有ドライブのメンバーではなくなった。
- ユーザーがメンバーである共有ドライブに直接関連する変更があります。次に例を示します。
- 共有ドライブでユーザーのアクセスレベルが変更された。
- 共有ドライブの名前が変更された。
ユーザーが共有ドライブのメンバーになると、共有ドライブに対する 1 つの変更イベントがユーザーの変更ログに表示されます。これは、共有ドライブ内のすべてのアイテムに対するアクセス権を意味します。メンバーになっても、共有ドライブ内のアイテムの変更を受け取ることはできません。
共有ドライブのメンバーには、共有ドライブ内のアイテムの使用状況に基づいて、変更イベントが表示されることがあります。ただし、ユーザーが共有ドライブのメンバーである場合は、アプリケーションでこれらのイベントに依存しないようにしてください。代わりに、共有ドライブの変更ログを使用して変更を追跡してください。
メンバー以外のユーザーに共有ドライブ内の個々のアイテムに対するファイル アクセス権が付与されている場合、それらのアイテムに対する変更はユーザーの変更履歴で追跡されます。これは、ユーザーと直接共有されるドライブの非共有アイテムと同じです。
共有ドライブの変更履歴に表示される変更
共有ドライブのメンバーであるユーザーは、その共有ドライブの変更履歴にアクセスできます。これには、次のものが含まれます。
- 共有ドライブ自体に対する変更（メンバーの追加、削除など）
- 共有ドライブ内のアイテムに対する直接変更。
権限と機能の同期
共有ドライブまたは共有ドライブ内のアイテムに対する権限の変更は、アイテム自体にのみ反映されます。そのアイテムの直接または間接の子はすべてこの変更を継承しますが、各アイテムの変更履歴に個別のエントリはありません。親が変更された場合、クライアントは新しい機能を伝えるか、各アイテムを再取得して変更を完全に再構築する必要があります。