관리자 활동 보고서

관리자 활동 보고서에는 모든 계정 관리자의 관리 콘솔 활동에 대한 정보가 표시됩니다. 각 보고서는 관리자 이름 또는 특정 관리 콘솔 이벤트와 같은 보고서별 매개변수와 함께 기본 보고서 엔드포인트 요청을 사용합니다. 각 보고서의 최대 기간은 최근 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_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": ""
       }
      ]
     }
    ]
   }
  ]
 }