O relatório de atividade de login retorna informações sobre as atividades de login de todos os usuários da sua conta. Cada relatório usa a solicitação básica de ponto de extremidade de relatório com parâmetros específicos do relatório, como o e-mail do usuário. A para cada relatório são os últimos 180 dias.
O relatório de atividade de login só pode ser usado para fins legais de acordo com o Contrato do Cliente.
Recuperar eventos de login do Google Workspace de um domínio
Para recuperar todos os logins de todos os serviços do seu domínio, use o seguinte
GET e inclua o token de autorização descrito no
documentação de autorização.
Para mais informações sobre as strings de consulta de solicitação e as propriedades de resposta,
consulte a Referência da API.
Para facilitar a leitura, o exemplo a seguir é formatado com retornos de linha:
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
O exemplo a seguir gera um relatório sobre todos os eventos de login da sua conta para
nos últimos 180 dias. O parâmetro de consulta maxResults faz com que esse relatório retorne
25 resultados por página.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
O exemplo a seguir gera um relatório sobre todos os eventos de login de um cliente para
nos últimos 180 dias. O customerId especifica para qual cliente o relatório é.
que serão recuperados.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
Recuperar eventos de login do Google Workspace por nome de evento
Em alguns casos, pode ser necessário recuperar
eventos,
como logins suspeitos. Para isso, use uma solicitação HTTP GET de
da seguinte forma:
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
O exemplo a seguir mostra como recuperar todos os logins suspeitos bem-sucedidos para um domínio:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25