La API de informes es una API de RESTful que puedes usar para acceder a información sobre las actividades de Google Workspace de tus usuarios. La API de informes forma parte de la API del SDK de Admin.
La API de informes proporciona dos tipos de informes:
- Informes de actividad, que informan eventos para una aplicación o servicio específicos, como Google Drive o la Consola del administrador.
- Informes de uso, que enumeran los eventos del lugar de trabajo causados por los usuarios
- Los informes de uso de los clientes enumeran los eventos de todos los usuarios de tu dominio.
- Los informes de uso del usuario enumeran los eventos organizados por usuario.
A continuación, se incluye una lista de los términos comunes que se usan en la API de informes:
- Informes de actividad
Los informes de actividad enumeran información sobre las actividades en una aplicación o servicio específico de Google Workspace. Los informes de actividad incluyen la fecha, la hora, el usuario y el tipo de actividad. La referencia de la API contiene una lista completa de los informes de actividad y la información que incluyen. Estos son algunos ejemplos de informes de actividad, ordenados por aplicación o servicio:
- Los informes de actividad del administrador muestran las actividades que realizaron los administradores mediante la Consola del administrador. Por ejemplo, puedes obtener una lista de todas las veces que los administradores cambiaron el nombre de un usuario mediante la Consola del administrador.
- Los informes de actividad de Google Drive muestran cómo los usuarios de tu dominio editan y ven sus documentos de Drive. Por ejemplo, puedes obtener una lista de la actividad de un usuario específico en Drive.
- Los informes de actividad de acceso proporcionan información sobre cuándo los usuarios acceden a sus cuentas y salen de ellas. Por ejemplo, puedes obtener un informe de todos los accesos de tu dominio durante un período determinado.
- Los informes de actividad móvil muestran las actividades en dispositivos móviles administrados por la Administración de dispositivos móviles de Google. Por ejemplo, puedes recibir una notificación cuando los usuarios registren un dispositivo nuevo.
- Los informes de actividad de tokens de OAuth enumeran eventos cuando tus usuarios otorgaron o revocaron tokens de autorización utilizados por aplicaciones y sitios web de terceros. Puedes usar la API de informes para obtener una lista de todos los accesos de terceros a los datos de Google Workspace de un usuario.
- Informes de uso
Los informes de uso proporcionan información sobre los eventos de Google Workspace en tu dominio. Puedes usar la API para solicitar información específica sobre los usuarios.
- Los informes de uso de los clientes muestran una lista detallada de las actividades de aplicación y servicio de tu cuenta. Esta información de uso está organizada por tipo de aplicación y contiene información específica de esa aplicación.
- En los informes de uso de los usuarios, se muestran las actividades de los usuarios de tu cuenta. Estos informes se pueden personalizar y filtrar para obtener información de uso específica. Esta información de uso está organizada por tipo de aplicación y contiene información específica de esa aplicación.
- En los informes de uso de entidades, se muestran las actividades relacionadas con las entidades que usan los usuarios de tu cuenta en la aplicación de Currents.
- Notificaciones
- La API de informes proporciona notificaciones que te permiten observar eventos, como cambios en los recursos. Cuando observas un recurso que cambia, la API de informes te envía una notificación. Si quieres obtener más información para configurar y recibir notificaciones de la API de informes, consulta la guía Recibe notificaciones push.
Próximos pasos
Para obtener información sobre la API de informes y ver cómo funciona, usa una guía de inicio rápido, que se enumeran por lenguaje de programación en la barra de navegación izquierda. También puedes continuar a través de esta sección para leer información general sobre cómo configurar tu cuenta.
Si quieres usar la API de informes, sigue los requisitos previos para configurar tu cuenta y convertirte en administrador. También crearás un proyecto y lo registrarás con la Consola de API de Google. Luego, activarás el servicio de la API de informes.
En la sección Autorización, se muestra cómo usar los tokens de acceso de OAuth 2.0 para obtener datos del usuario de las aplicaciones y los servicios de Google Workspace.
Para obtener más información sobre un tipo de recurso o método específico, consulta la referencia de la API.
Si deseas obtener más información, consulta la Herramienta de seguimiento de errores de la API del SDK de Admin, el blog para desarrolladores de Google Workspace y el Centro de ayuda para administradores de Google Workspace.