Google Drive Activity API は、ユーザーの Google ドライブ内のオブジェクトに加えられた変更を表す DriveActivity リソースと、それらの変更に関する情報を取得するための activity.query メソッドで構成されています。
リクエスト
アプリが activity.query メソッドを使用してユーザーのアクティビティ データをリクエストする。特定のドライブ アイテムまたはドライブ フォルダに含まれるすべてのアイテムについて、アクティビティをリクエストできます。特定のリクエストに対して、期間やアクション タイプなどの制約によってレスポンスを制限できます。また、レスポンスにアクティビティを統合することもできます。詳しくは、Drive Activity API でリクエストするをご覧ください。
レスポンス
リクエストに対するレスポンスは、特定のパラメータに一致するアクティビティのリストです。DriveActivity リソースは各アクティビティを表します。
DriveActivity リソースは、Action オブジェクトのコレクションです。各オブジェクトは、イベントのように自己完結しています。Action には、ActionDetail（Create や Edit など）、Actor（User や Administrator など）、Target（DriveItem、Drive など）、Timestamp や TimeRange があります。
DriveActivity リソースには、すべてのアクションの Actor や Target など、統合された Timestamp または TimeRange や、Action の最も重要なものまたは代表的な ActionDetail など、概要情報が含まれます。
詳しくは、Drive Activity API のデータモデルをご覧ください。
アクティビティ履歴の公開設定
この API を使用すると、ドライブの一部のアクティビティが報告されないことがあります。Drive Activity API がオブジェクトに対して特定の変更をレポートするかどうかは、変更内容、またはその変更に関する情報がアプリケーション内の認証済みユーザーに表示されているかどうかによって異なります。
表示設定は、オブジェクトに設定されている権限に基づきます。ドライブでファイルやフォルダを共有する場合、次のようなシナリオがあります。
- 作成者がドキュメントを共有すると、そのドキュメントのアクティビティ履歴は作成者だけでなく、共有先の認証済みユーザーにも適用されます。
- ドキュメントをユーザーと共有してから非公開にした場合、認証されたユーザーはアクセス権のあるすべてのアクティビティ履歴を表示して、権限が制限されたことを確認できます。
- ドキュメントがユーザーと共有したことがない場合、ユーザーにはアクティビティ履歴は表示されません。
スタートガイド
Drive Activity API を最大限に活用するには、まずアプリを Google Drive API と統合します。Drive Activity API の使用を開始するには、プロジェクトの作成方法とリクエストの承認方法をご覧ください。または、API リファレンスでアクティビティについて詳細をご覧ください。