Google Drive Activity API の概要

Google Drive Activity API は、ユーザーの Google ドライブ内のオブジェクトに加えられた変更を表す DriveActivity リソースと、それらの変更に関する情報を取得できる activity.query メソッドで構成されます。

リクエスト

アプリが activity.query メソッドを使用して、ユーザーのアクティビティ データをリクエストします。特定のドライブ アイテムまたはドライブ フォルダ内のアイテムに対するアクティビティをリクエストできます。特定のリクエストについて、期間やアクション タイプなどの制約によってレスポンスを制限したり、アクティビティをレスポンスに統合したりできます。詳しくは、Drive Activity API でリクエストを行うをご覧ください。

レスポンス

リクエストに対するレスポンスは、指定されたパラメータに一致するアクティビティのリストです。DriveActivity リソースは各アクティビティを表します。

ドライブのアクティビティの説明。

DriveActivity リソースは Action オブジェクトのコレクションであり、各オブジェクトはイベントのように自己完結型です。Action には、ActionDetailCreateEdit など)、ActorUserAdministrator など)、TargetDriveItemDrive など)、Timestamp または TimeRange のいずれかが含まれます。

DriveActivity リソースには、すべてのアクションのすべての ActorTarget、統合された Timestamp または TimeRangeAction の最も重要な ActionDetail または代表的な ActionDetail など、概要情報も含まれます。

詳しくは、Drive Activity API データモデルをご覧ください。

アクティビティ履歴の公開設定

この API を使用すると、ドライブ上での一部のアクティビティが報告されない場合があります。Drive Activity API がオブジェクトに特定の変更を報告するかどうかは、その変更または変更に関する情報が、アプリケーションで認証されたユーザーに表示されるかどうかによって異なります。

可視化は、オブジェクトに設定された権限に基づいて決まります。ドライブでファイルやフォルダを共有する場合、次のようなシナリオがあります。

  • 作成者がドキュメントを共有すると、そのドキュメントのアクティビティ履歴は作成者だけでなく、共有先の認証済みユーザーにも表示されます。
  • あるユーザーとドキュメントを共有した後で限定公開にすると、認証されたユーザーは、アクセス権があり、権限が制限されている間、すべてのアクティビティ履歴を表示できます。
  • ドキュメントがユーザーと共有されていなかった場合、ユーザーはアクティビティ履歴を表示できません。

使ってみる

Drive Activity API を最大限に活用するには、まずアプリを Google Drive API と統合します。Drive Activity API の使用を開始するには、プロジェクトを作成してリクエストを承認する方法をご覧ください。または、API リファレンスで詳細を確認してください。