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