Reports API: 로그인 활동 보고서

로그인 활동 보고서는 관리하게 됩니다. 각 보고서는 사용자 이메일 등 보고서 관련 매개변수 이 각 보고서의 최대 기간은 최근 180일입니다.

로그인 활동 보고서는 고객 계약에 따라 합법적인 목적으로만 사용할 수 있습니다.

도메인의 Google Workspace 로그인 이벤트 가져오기

도메인의 모든 서비스에 대한 모든 로그인을 검색하려면 다음을 사용하세요. GET HTTP 요청을 호출하고 다음에 설명된 승인 토큰을 포함합니다. 승인 문서가 필요합니다. 요청 쿼리 문자열과 응답 속성에 대한 자세한 내용은 API 참조를 확인하세요. 다음 예시는 가독성을 위해 줄 반환으로 형식이 지정됩니다.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/login?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/login?maxResults=25

다음 예시에서는 지난 180일 동안 집계되었습니다 customerId는 보고할 고객을 지정합니다. 가져올 수 있습니다.

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

이벤트 이름별로 Google Workspace 로그인 이벤트 가져오기

경우에 따라 특정 이벤트 의심스런 로그인이 있습니다. 이렇게 하려면 GET HTTP 요청을 사용합니다. 다음 양식을 작성해 주시기 바랍니다.

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

다음 예시는 의심스러운 모든 로그인을 검색하는 방법을 보여줍니다. 다음 사항을 참조하세요.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25