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 または代表的な ActionDetail など、概要情報も含まれます。
詳細については、Drive Activity API のデータモデルをご覧ください。
アクティビティ履歴の公開設定
この API を使用すると、ドライブのアクティビティの一部が報告されないことがあります。Drive Activity API がオブジェクトに対する特定の変更を報告するかどうかは、その変更または変更に関する情報がアプリケーションの認証済みユーザーに表示されるかどうかによって異なります。
公開設定は、オブジェクトに設定された権限に基づきます。ドライブでファイルやフォルダを共有するシナリオはいくつかあります。
- 作成者がドキュメントを共有すると、ドキュメントのアクティビティ履歴は作成者だけでなく、共有された認証済みユーザーにも表示されます。
- ドキュメントがユーザーと共有された後で非公開になった場合、認証されたユーザーは、アクセス権があった期間のすべてのアクティビティ履歴と、権限が制限されたことを確認できます。
- ドキュメントがユーザーと共有されたことがない場合、ユーザーはアクティビティ履歴を確認できません。
始める
Drive Activity API を最大限に活用するには、まずアプリを Google Drive API と統合します。Drive Activity API を使用するには、プロジェクトを作成し、リクエストを承認する方法をご確認ください。または、API リファレンスでアクティビティについて直接お読みください。