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