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 Reports forma parte de la API de Admin SDK.
La API de informes proporciona dos tipos de informes:
- Informes de actividad, que informan eventos de una aplicación o un servicio específico, como Google Drive o la Consola del administrador.
- Informes de uso, que enumeran los eventos de espacio de trabajo causados por los usuarios.
- Los informes de uso de Customer muestran eventos para todos los usuarios de tu dominio.
- Los informes de uso de User enumeran eventos organizados por usuario.
A continuación, se muestra una lista de los términos comunes que se usan en la API de Reports:
- Informes de actividad
Los informes de actividad incluyen información sobre las actividades de una aplicación o un servicio de Google Workspace en particular. Los informes de actividad incluyen la fecha, hora, usuario y tipo de actividad. La referencia de 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:
- En los informes de actividad del administrador, se muestran las actividades que realizaron los administradores por medio de 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 indican 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 en particular 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 en particular.
- Los informes de actividad en dispositivos móviles muestran actividades mediante los dispositivos móviles que administra la Administración de dispositivos móviles de Google. Por ejemplo, puedes recibir una notificación cuando los usuarios registren un dispositivo nuevo.
- En los informes de actividad de token OAuth, se enumeran los eventos cuando tus usuarios otorgaron o revocaron tokens de autorización que usan las apps y los sitios web de terceros. Puedes usar la API de Reports 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.
- En los informes de uso de los clientes, se indican las actividades detalladas de aplicación y servicio en tu cuenta. Esta información de uso se organiza por tipo de aplicación y contiene información específica de esa aplicación.
- Los informes de uso de los usuarios muestran las actividades que realizaron 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 se organiza por tipo de aplicación y contiene información específica de esa aplicación.
- En Informes de uso de entidades, se enumeran 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 ver eventos, como cambios en los recursos. Cuando observas un recurso y ese recurso cambia, la API de informes te envía una notificación. Para obtener más información sobre la configuración y la recepción de notificaciones desde la API de informes, consulta la guía Recibe notificaciones push.
Próximos pasos
Para obtener información sobre la API de Reports y ver cómo funciona, usa una guía de inicio rápido, que se muestra por lenguaje de programación en la barra de navegación izquierda. También puedes seguir con esta sección para leer información general sobre cómo configurar tu cuenta.
Si quieres usar la API de Reports, 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 la API de Google, y activarás el servicio de la API de informes.
En la sección sobre autorización, se muestra cómo usar tokens de acceso de OAuth 2.0 para obtener datos del usuario de aplicaciones y servicios de Google Workspace.
Para encontrar los detalles de un tipo de recurso o método específico, consulta la referencia de API.
Para 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.