ドライブ アクティビティ レポートには、Google Workspace の Google ドライブでユーザーがファイルを管理、変更、共有したときのアクティビティに関する情報が表示されます。たとえば、ドライブ アクティビティ レポートを使用して、特定のユーザーが指定した期間に作成したすべての新しいドライブ ドキュメントのリストを取得できます。この情報を使用して、コンテンツ管理の改善とデータ漏洩の可能性に関する分析情報を取得できます。レポートを取得するには、ユーザーのメールアドレスや特定の種類の Google ドライブの変更など、レポート固有のパラメータを指定して基本レポート エンドポイント リクエストを使用します。レポートには、過去 180 日間のデータを含めることができます。
Google ドライブ アクティビティ レポートは、ライセンスが割り当てられているアカウントで、合法的な目的でのみ使用できます。
リクエストのクエリ文字列とレスポンスのプロパティについては、API リファレンスをご覧ください。Google ドライブに関連する特定のイベントについては、ドライブのイベント名をご覧ください。
ドメインの Google ドライブ イベントを取得する
ドライブ アクティビティ レポートを使用すると、ドライブ ドキュメントに関する情報を一覧表示できます。たとえば、アカウントの最新のドライブ イベント 25 件を一覧表示するレポートをリクエストできます。このレポートでは、最長 180 日間のイベントを対象にできます。このレポートを取得するには、認証ガイドの説明に沿って認証トークンを取得し、次の HTTP GET リクエストを使用します。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
この API 呼び出しのレスポンスの例をご覧ください。
次の例では、過去 180 日間（最長期間）のすべてのドライブ イベントのレポートを取得します。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
ユーザー別の Google ドライブ イベントを取得する
特定のユーザーの Google ドライブ アクティビティのレポートを取得するには、認可ガイドで説明されている認可トークンを使用して HTTP GET リクエストを使用します。userKey フィールドは、レポート内のユーザーのメインのメールアドレス、またはすべてのユーザーの all です。
次の例では、指定されたユーザーが行ったすべての変更を一覧表示するレポートを取得します。API レスポンスの例については、サンプル JSON レスポンスをご覧ください。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
共有ドライブの Google ドライブ イベントを取得する
特定の共有ドライブの Google ドライブ アクティビティのレポートを取得するには、認証ガイドで説明されている認証トークンを含む HTTP GET リクエストを使用します。レポートを実行するユーザーのメールアドレスを userKey フィールドに指定するか、all を指定してすべてのユーザーに対してレポートを実行します。
次の例では、特定の共有ドライブのすべての変更のレポートを取得します。API レスポンスの例については、サンプル JSON レスポンスをご覧ください。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
共有ドライブのイベントを取得するには、doc_type を使用してフィルタします。次の例では、すべての共有ドライブに影響するイベントを取得します。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
メンバーシップの変更のイベントを取得するには、shared_drive_membership_change イベントを指定します。次の例では、共有ドライブに追加されたすべてのメンバーを取得します。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
イベント タイプ別に Google ドライブのイベントを取得する
ドキュメントの作成や編集など、特定のイベントタイプのすべてのインスタンスのレポートを取得するには、認証ガイドで説明されている認証トークンを使用して HTTP GET リクエストを使用します。userKey フィールドは、レポート内のユーザーのメインのメールアドレス、またはすべてのユーザーの all です。
次の例では、アカウント ドキュメントの作成アクティビティのレポートを取得します。API レスポンスの例については、サンプル JSON レスポンスをご覧ください。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
JSON レスポンスの例
API に HTTP GET リクエストを行うと、成功したレスポンスは HTTP 200 ステータス コードを返します。レスポンスには、ステータス コードとともにドライブのレポートが返されます。これらのレポートは管理コンソールでも確認できます。詳しくは、Google Workspace 管理者用ヘルプセンターをご覧ください。eventName については、ドライブのイベント名のリファレンスをご覧ください。リクエストのクエリ文字列とレスポンスのプロパティの詳細については、API リファレンスをご覧ください。
{
"kind": "reports#auditActivities",
"nextPageToken": "next page's token",
"items": [
{
"kind": "audit#activity",
"id": {
"time": "2014-03-17T15:39:18.460Z",
"uniqQualifier": "report's unique ID",
"applicationName": "drive",
"customerId": "ABC123xyz"
},
"actor": {
"callerType": "USER",
"email": "kim@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in an OAuth 2LO request"
},
"ownerDomain": "domain of the source owner",
"ipAddress": "user's IP address",
"events": [
{
"type": "access",
"name": "edit",
"parameters": [
{
"name": "primary_event",
"boolValue": true
},
{
"name": "owner_is_shared_drive",
"boolValue": false
}, {
"name": "doc_id",
"value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
},
{
"name": "doc_title",
"value": "Meeting notes"
},
{
"name": "doc_type",
"value": "document"
},
{
"name": "owner",
"value": "mary@example.com"
}
]
}
]
},
]
}