로그인 활동 보고서는 모든 계정 사용자의 로그인 활동에 관한 정보를 반환합니다. 각 보고서는 사용자 이메일과 같은 보고서별 매개변수가 있는 기본 보고서 엔드포인트 요청을 사용합니다. 각 보고서의 최대 기간은 최근 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