Google Drive Activity API の概要

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

リクエスト

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

レスポンス

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

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

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

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

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

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

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

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

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

スタートガイド

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