API de Reports: 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 dispositivos de Administración de extremos de Google. Cada informe usa la solicitud básica de extremo de informe con recursos como el correo electrónico del usuario. El período máximo de cada informe es los últimos 180 días.

El informe de actividad de auditoría del dispositivo solo puede usarse con fines legales en conforme a su Acuerdo del Cliente. Consulta Compara las ediciones de Google Workspace para ver qué ediciones incluyen estos informes.

Recuperar eventos de auditoría de dispositivos de un dominio

Si deseas recuperar todos los eventos de auditoría de dispositivos para todos los usuarios de tu dominio, usa el después de la 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, ver Eventos de actividad de auditoría de dispositivos. 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/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 de los últimos 180 días. El parámetro de consulta maxResults devuelve 25 resultados por .

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. El customerId especifica qué informe del cliente se recupera.

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

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

En algunos casos, es posible que quieras recuperar datos eventos, como eventos de actividad sospechosa. Para ello, usa una solicitud HTTP GET en el siguiente formato:

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

El siguiente ejemplo muestra cómo recuperar todos los eventos de actividades sospechosas para Usuarios de Android dentro del dominio:

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