このページは Cloud Translation API によって翻訳されました。

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

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

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

ドメインの Google ドライブ イベントを取得する