管理アクティビティ レポート

管理アクティビティ レポートでは、アカウントの管理者全員の管理コンソールでのアクティビティに関する情報を確認できます。各レポートでは、管理者の名前や特定の管理コンソールのイベントなどのレポート固有のパラメータを含む、レポート エンドポイントの基本リクエストが使用されます。各レポートの最大期間は過去 180 日間です。

管理アクティビティ レポートは、顧客契約に従い、合法的な目的にのみ使用することができます。また、このレポートは Google Workspace、Education、ISP のアカウントに適用されます。

すべての管理アクティビティを取得する

アカウントに対して行われたすべての管理アクティビティのレポートを取得するには、次の GET HTTP リクエストを使用し、承認に関するドキュメントに記載されている認証トークンを含めます。リクエストのクエリ文字列とレスポンスのプロパティの詳細については、API リファレンスをご覧ください。次の例では、読みやすくするために改行を挿入しています。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?endTime=a date&startTime=a date
&maxResults=number of events listed on each page of the report

次の例では、過去 180 日間(レポートの最大期間)におけるアカウントの管理アクティビティすべてに関するレポートを取得します。また、maxResults クエリ文字列により、このレポートにはレポートのページごとに 2 つのイベントが含まれることが判別されます。API レスポンスの例については、JSON レスポンスの例をご覧ください。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=2

次の例では、過去 180 日間の顧客管理アクティビティすべてに関するレポートを取得します。customerId には、レポートを取得する顧客を指定します。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?customerId=C03az79cb

管理者によるすべてのアクティビティを取得する

特定の管理者が行ったすべての管理コンソールのアクティビティに関するレポートを取得するには、次の GET HTTP リクエストを使用して、承認に関するドキュメントに記載されている認証トークンを含めます。userKey は、レポート内の管理者のメインのメールアドレスです。リクエストのクエリ文字列とレスポンスのプロパティの詳細については、API リファレンスをご覧ください。次の例では、読みやすくするために改行を挿入しています。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey
/applications/admin?endTime=a date&startTime=a date
&maxResults=number of events listed on each page of the report
&filters=event name parameter relational operator parameter value

次の例では、john@example.com によって管理コンソール アプリケーションに加えられたすべての変更に関するレポートを取得し、OLD_VALUEALLOW_CAMERA と等しいすべてのアクティビティを返すようにレスポンスをフィルタしています。API レスポンスの例については、JSON レスポンスの例をご覧ください。アクティビティについては、管理者イベント名をご覧ください。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA

イベント名ですべてのアクティビティを取得する

特定のイベント名のすべてのアクティビティのレポートを取得するには、次の GET HTTP リクエストを使用して、承認のドキュメントに記載されている認証トークンを含めます。eventName の情報については、管理者イベント名のリファレンス情報をご覧ください。リクエストのクエリ文字列とレスポンスのプロパティの詳細については、API リファレンスをご覧ください。次の例では、読みやすくするために改行を挿入しています。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?endTime=a date&startTime=a date
&maxResults=maximum number of events returned on a response page
&eventName=name of the administrative event

次の例では、管理コンソールでユーザーの姓が変更されたすべてのインスタンスに関するレポートを取得します。API レスポンスの例については、JSON レスポンスの例をご覧ください。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME

イベントと管理者ごとにすべてのアクティビティを取得する

特定の管理者が特定のイベント名に対して行った管理コンソールのすべての変更のレポートを取得するには、次の GET HTTP リクエストを使用して、承認に関するドキュメントに記載されている認証トークンを含めます。userKey は、レポート内の管理者のメインのメールアドレスです。eventName の情報については、管理者イベント名のリファレンス情報をご覧ください。リクエストのクエリ文字列とレスポンスのプロパティの詳細については、API リファレンスをご覧ください。次の例では、読みやすくするために改行を挿入しています。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey
/applications/admin?endTime=a date&startTime=a date
&maxResults=maximum number of events returned on a response page
&eventName=name of the administrative event

次の例では、john@example.com によって特定のユーザーの姓に対して行われたすべての管理コンソールの変更に関するレポートを取得します。API レスポンスの例については、JSON レスポンスの例をご覧ください。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME

管理アクティビティ レポートの JSON レスポンスの例

成功すると、HTTP 200 のステータス コードが返されます。レスポンスでは、ステータス コードとともにレポートが返されます。eventName の情報については、管理者イベント名のリファレンス情報をご覧ください。リクエストの URL クエリ文字列とレスポンス プロパティの詳細については、API リファレンスをご覧ください。

{
 "kind": "reports#auditActivities",
 "nextPageToken": "the next page's token",
 "items": [
  {
   "kind": "audit#activity",
   "id": {
    "time": "2011-06-17T15:39:18.460Z",
    "uniqueQualifier": "report's unique ID",
    "applicationName": "admin",
    "customerId": "C03az79cb"
   },
   "actor": {
    "callerType": "USER",
    "email": "liz@example.com",
    "profileId": "user's unique Google Workspace profile ID",
    "key": "consumer key of requestor in OAuth 2LO requests"
   },
   "ownerDomain": "example.com",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "GROUP_SETTINGS",
     "name": "CHANGE_GROUP_SETTING",
     "parameters": [
      {
        "name": "SETTING_NAME",
        "value": "WHO_CAN_JOIN",
        "intValue": "integer value of parameter",
        "boolValue": "boolean value of parameter"
      }
     ]
    }
   ]
  },
  {
   "kind": "audit#activity",
   "id": {
    "time": "2011-06-17T15:39:18.460Z",
    "uniqueQualifier": "reports unique ID",
    "applicationName": "admin",
    "customerId": "C03az79cb"
   },
   "actor": {
    "callerType": "USER",
    "email": "liz@example.com",
    "profileId": "user's unique Google Workspace profile ID",
    "key": "consumer key of requestor in an OAuth 2LO request"
   },
   "ownerDomain": "example.com",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "GROUP_SETTINGS",
     "name": "CREATE_GROUP",
     "parameters": [
      {
        "name": "GROUP_EMAIL",
        "value": "helpdesk@example.com",
        "intValue": "",
        "boolValue": ""
       }
      ]
     }
    ]
   }
  ]
 }