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 リファレンスで詳細を確認してください。