Reports API: 기기 감사 활동 보고서

기기 감사 활동 보고서는 Google 엔드포인트 관리의 모든 기기의 활동에 관한 정보를 반환합니다. 각 보고서는 사용자 이메일과 같은 보고서별 매개변수가 있는 기본 보고서 엔드포인트 요청을 사용합니다. 각 보고서의 최대 기간은 최근 180일입니다.

기기 감사 활동 보고서는 고객 계약에 따라 합법적인 목적으로만 사용할 수 있습니다. Google Workspace 버전 비교에서 이러한 보고서가 포함된 버전을 확인하세요.

도메인의 기기 감사 이벤트 검색

도메인 내 모든 사용자의 모든 기기 감사 이벤트를 가져오려면 다음 GET HTTP 요청을 사용하고 승인 문서에 설명된 승인 토큰을 포함합니다. 요청 쿼리 문자열 및 응답 속성에 관한 자세한 내용은 기기 감사 활동 이벤트를 참고하세요. 가독성을 위해 다음 예시에는 줄바꿈이 적용되어 있습니다.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

다음 예에서는 지난 180일 동안 계정의 모든 기기 감사 이벤트에 관한 보고서를 가져옵니다. maxResults 쿼리 매개변수는 페이지당 25개의 결과를 반환합니다.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25

다음 예에서는 지난 180일 동안의 모든 기기 감사 이벤트에 관한 보고서를 가져옵니다. customerId는 어떤 고객의 보고서를 가져올지 지정합니다.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb

이벤트 이름별 기기 감사 이벤트 가져오기

경우에 따라 의심스러운 활동 이벤트와 같은 특정 이벤트를 검색해야 할 수 있습니다. 이렇게 하려면 다음 형식의 GET HTTP 요청을 사용합니다.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?maxResults=maximum number of events returned on a response page
&eventName=name of the event
&filters=event parameter relational operator parameter value

다음 예는 도메인 내 Android 사용자의 모든 의심스러운 활동 이벤트를 검색하는 방법을 보여줍니다.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25