ドライブのアクティビティ レポートには、ユーザーのアクティビティ ユーザーが Google Workspace の Google ドライブでファイルを管理、変更、共有する場合。 たとえば、ドライブのアクティビティ レポートを使用すると、 すべての新規ドライブ ドキュメントを 日付範囲を指定しますこの情報を使用して コンテンツ管理を改善し データ漏洩の可能性を低減できますレポートを取得するには、次のコマンドを使用します。 レポート固有のパラメータを含む基本レポート エンドポイント リクエスト( ユーザーのメールアドレスや Google ドライブに関する特定の種類の変更に対して通知できます。レポートは これには過去 180 日間までのデータが含まれます
Google ドライブ アクティビティ レポートは、 ライセンスが割り当てられています。
リクエストのクエリ文字列とレスポンスのプロパティについては、 API リファレンスをご覧ください。対象 Google ドライブに関連する特定のイベントについては、 ドライブのイベント名。
ドメインの Google ドライブのイベントを取得する
ドライブのアクティビティ レポートを使用すると、
ドライブのドキュメント。たとえば、ある特定の Google Cloud Storage バケットを
アカウントでの直近 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 ドライブ アクティビティのレポートを取得できます。
認証トークン(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" } ] } ] }, ] }