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