관리자 활동 보고서

관리자 활동 보고서는 계정의 모든 관리자의 관리 콘솔 활동에 관한 정보를 반환합니다. 각 보고서는 관리자 이름이나 특정 관리 콘솔 이벤트와 같은 보고서별 매개변수와 함께 기본 보고서 엔드포인트 요청을 사용합니다. 각 보고서의 최대 기간은 지난 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 쿼리 문자열은 보고서 페이지당 이벤트가 두 개 포함된 보고서를 결정합니다. 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": ""
       }
      ]
     }
    ]
   }
  ]
 }