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