API de informes: Informe de actividad de auditoría de dispositivos

El informe de actividad de auditoría del dispositivo muestra información sobre las actividades de todos los dispositivos en la Administración de extremos de Google. Cada informe utiliza la solicitud básica de extremo del informe con parámetros específicos del informe, como el correo electrónico de un usuario. El período máximo para cada informe son los últimos 180 días.

El informe de actividad de auditoría del dispositivo solo se puede usar con fines legales de conformidad con tu Acuerdo de cliente. Consulta Comparación de las ediciones de Google Workspace para descubrir qué ediciones incluyen estos informes.

Recuperar los eventos de auditoría de dispositivos de un dominio

A fin de recuperar todos los eventos de auditoría de dispositivos para todos los usuarios de tu dominio, usa la siguiente solicitud HTTP GET e incluye el token de autorización descrito en la documentación de autorización. Para obtener más información sobre las strings de consulta de solicitud y las propiedades de respuesta, consulta Eventos de actividad de auditoría de dispositivos. Para facilitar la lectura, el siguiente ejemplo tiene un formato con resultados de línea:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

En el siguiente ejemplo, se obtiene un informe sobre todos los eventos de auditoría de dispositivos de tu cuenta durante los últimos 180 días. El parámetro de consulta maxResults muestra 25 resultados por página.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25

En el siguiente ejemplo, se obtiene un informe sobre todos los eventos de auditoría de dispositivos de los últimos 180 días. customerId especifica el informe del cliente que se recupera.

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

Recuperar eventos de auditoría de dispositivos por nombre de evento

En algunas instancias, es posible que desees recuperar eventos específicos, como eventos de actividad sospechosa. Para ello, usa una solicitud HTTP GET de la siguiente manera:

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

En el siguiente ejemplo, se muestra cómo recuperar todos los eventos de actividad sospechosa para usuarios de Android en el dominio:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25