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

管理者アクティビティ レポートは、アカウントのすべての管理者の管理コンソール アクティビティに関する情報を返します。各レポートは、レポート固有のパラメータ（管理者の名前や特定の管理コンソール イベントなど）を含む基本レポート エンドポイント リクエストを使用します。各レポートの最大期間は過去 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_VALUE が ALLOW_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 requester 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 requester 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": ""
       }
      ]
     }
    ]
   }
  ]
 }