Reports API: ドライブ アクティビティ レポート

ドライブのアクティビティ レポートには、ユーザーのアクティビティ ユーザーが 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"
      }
      ]
     }
    ]
   },
  ]
 }