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