El informe de actividad de auditoría de dispositivos muestra información sobre las actividades de todos los dispositivos que se encuentran en la administración de extremos de Google. Cada informe usa la solicitud de extremo de informe básica con parámetros específicos del informe, como el correo electrónico de un usuario. El período máximo de cada informe es de los últimos 180 días.
El informe de actividad de auditoría de dispositivos solo se puede usar con fines legales de conformidad con tu Acuerdo con el Cliente. Consulta Comparar las ediciones de Google Workspace para saber qué ediciones incluyen estos informes.
Cómo recuperar eventos de auditoría de dispositivos para un dominio
Para recuperar todos los eventos de auditoría de dispositivos de todos los usuarios de tu dominio, usa la siguiente solicitud HTTP GET y, luego, incluye el token de autorización que se describe en la documentación de autorización.
Para obtener más información sobre las cadenas de consulta de solicitudes y las propiedades de respuesta, consulta Eventos de actividad de auditoría de dispositivos.
Para facilitar la lectura, el siguiente ejemplo tiene formato con saltos 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 de 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 de todos los eventos de auditoría de dispositivos de los últimos 180 días. customerId especifica el informe de qué cliente se recupera.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb
Cómo recuperar eventos de auditoría de dispositivos por nombre de evento
En algunos casos, es posible que desees recuperar eventos específicos, como los eventos de actividad sospechosa. Para ello, usa una solicitud HTTP GET con 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
En el siguiente ejemplo, se muestra cómo recuperar todos los eventos de actividad sospechosa de los 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