このドキュメントでは、Google ドライブ Activity API の概要について説明します。
Drive Activity API を使用すると、最近のイベントをクエリできます。各イベントの詳細情報など、すべてのアクティビティの詳細な履歴を取得できます。これは監査などのタスクに役立ちます。ActionDetail、Actor、Target の情報を含む正確なアクティビティを取得できるためです。
Drive Activity API は、ユーザーの Google ドライブ内のオブジェクトに加えられた
変更を表す
DriveActivity リソースと、それらの変更に関する
情報を取得できる
activity.query メソッドで構成されています。
リクエスト
アプリは activity.query メソッドを使用して、ユーザーのアクティビティ データをリクエストします。特定ドライブ アイテムのアクティビティをリクエストすることも、ドライブ フォルダに含まれるすべてのアイテムのアクティビティをリクエストすることもできます。リクエストごとに、時間範囲やアクション タイプなどのフィルタを使用して
レスポンスを制限したり、レスポンスでアクティビティを統合したりできます。詳細については、
Google ドライブ Activity API でリクエストを行うをご覧ください。
レスポンス
レスポンスには、指定されたパラメータに一致するアクティビティのリストが含まれます。
各DriveActivityリソースは各
アクティビティを表します。
DriveActivity リソースは
Action オブジェクトのコレクションです。各オブジェクトは、
イベントのように自己完結型です。Action には、ActionDetail（Create や Edit など）、Actor（User や Administrator など）、Target（DriveItem や Drive など）、
Timestamp
または TimeRange が含まれます。
DriveActivity リソースには、すべてのアクションの
Actor と Target、統合された Timestamp または TimeRange、
および Action の最も重要な ActionDetail または代表的な ActionDetail など、概要情報も含まれます。
詳細については、Drive Activity API データ モデルをご覧ください。
アクティビティ履歴の表示
Drive Activity API を使用しても、ドライブ上の一部の操作が報告されない場合があります。API がオブジェクトに対する特定の変更を報告するかどうかは、アプリで認証されたユーザーがその変更または変更に関する情報を確認できるかどうかによって異なります。
表示は、オブジェクトに設定された権限に基づきます。ドライブでファイルやフォルダが共有されるシナリオはいくつかあります。
作成者がドキュメントを共有した場合、ドキュメントのアクティビティ履歴は、作成者と共有相手の両方に表示されます。
ドキュメントがユーザーと共有された後、非公開になった場合、ユーザーはアクセス権があった期間のすべてのアクティビティ履歴を確認できますが、権限が制限された後は確認できません。
ドキュメントがユーザーと共有されていない場合、ユーザーはアクティビティ履歴を確認できません。
関連トピック
- Drive Activity API を最大限に活用するには、まずアプリを Google Drive APIと統合します。
- プロジェクトの作成や認証と認可の処理など、Google Workspace API を使用した開発の詳細については、Google Workspace で開発するをご覧ください。
- アクティビティの詳細については、API リファレンスをご覧ください。