El informe de actividad de acceso devuelve información sobre las actividades de acceso de todos los usuarios de tu cuenta. Cada informe usa la solicitud básica de extremo de informe con parámetros específicos del informe, como el correo electrónico del usuario. El el período máximo de cada informe son los últimos 180 días.
El informe de actividad de acceso solo se puede usar para fines legales de acuerdo con el Acuerdo del Cliente.
Recupera eventos de acceso de Google Workspace para un dominio.
Para recuperar todos los accesos de todos los servicios de tu dominio, usa el siguiente comando:
solicitud HTTP GET
e incluye el token de autorización descrito en el
documentación de autorización.
Para obtener más información sobre las cadenas de consulta de solicitud y las propiedades de las respuestas,
consulta la Referencia de la API.
Para facilitar la lectura, el siguiente ejemplo tiene un formato que muestra resultados de líneas:
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
En el siguiente ejemplo, se obtiene un informe de todos los eventos de acceso de tu cuenta para
en los últimos 180 días. El parámetro de búsqueda maxResults
muestra este informe
25 resultados por página
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
En el siguiente ejemplo, se obtiene un informe de todos los eventos de acceso de un cliente para
en los últimos 180 días. El customerId
especifica de qué cliente se trata el informe.
que se debe recuperar.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
Recupera eventos de acceso de Google Workspace por nombre de evento
En algunos casos, es posible que quieras recuperar datos
eventos,
como accesos sospechosos exitosos. Para ello, usa una solicitud HTTP GET
de
el siguiente formato:
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
En el siguiente ejemplo, se muestra cómo recuperar todos los accesos sospechosos exitosos para un dominio:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25