Reports API: Device Audit 활동 보고서

기기 감사 활동 보고서는 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