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 リファレンスでアクティビティについて詳細をご覧ください。