La API de Reports es una API de RESTful que puedes usar para acceder a información sobre el Actividades de Google Workspace de tus usuarios. La API de Reports forma parte de la API del SDK de Admin.
La API de Reports proporciona dos tipos de informes:
- Los informes Actividad, que informan sobre los eventos de una aplicación específica o como Google Drive o la Consola del administrador.
- Los informes de Uso, en los que se enumeran los eventos del lugar de trabajo causados por los usuarios
- En los informes de uso de los clientes, se muestran los eventos de todos los usuarios de tu dominio.
- En los informes de uso de los usuarios, se muestran los eventos organizados por usuario.
A continuación, se incluye una lista de términos comunes usados en la API de Reports:
- Informes de actividad
En los informes de actividad, se muestra información de las actividades de un determinado Google Workspace para cada aplicación o servicio. Los informes de actividad incluyen la fecha, la hora, el usuario y el tipo de actividad. El Referencia de la API contiene una lista completa de informes de actividad y la información que incluyen. Estos son algunos ejemplos de informes de actividad, ordenados por aplicación o servicio:
- Informes de actividad del administrador mostrar las actividades que realizan los administradores por medio de la Consola del administrador Por ejemplo: Podrías obtener una lista de todas las veces que los administradores cambiaron el nombre de un usuario. mediante la Consola del administrador.
- Informes de actividad de Google Drive enumerar cómo los usuarios de tu dominio editan y ven sus documentos de Drive. Para Por ejemplo, puede obtener una lista de la actividad de un usuario específico en Drive.
- Informes de actividad de acceso proporcionar información sobre cuándo los usuarios de su cuenta acceden y salen de sus cuentas de servicio. Puede obtener, por ejemplo, un informe de todos los accesos de su dominio durante un período de tiempo determinado.
- Informes de actividad en dispositivos móviles mostrar actividades utilizando dispositivos móviles administrados por Administración de dispositivos móviles de Google. Por ejemplo, puedes recibir una notificación cuando los usuarios registran un dispositivo nuevo.
- Informes de actividad de tokens de OAuth Enumerar eventos cuando los usuarios otorgaron o revocaron tokens de autorización usados por sitios web y aplicaciones de terceros. Puedes usar la API de Reports para 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.
- Informes de uso de clientes Enumera las actividades detalladas de aplicaciones y servicios en tu cuenta. Este uso información se organiza por tipo de aplicación y contiene información específicas de esa aplicación.
- Informes de uso de los usuarios mostrar las actividades realizadas por los usuarios de su cuenta. Estos informes se pueden personalizar 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.
- Informes de uso de entidades Enumera las actividades relacionadas con las entidades utilizadas por los usuarios de tu cuenta en la App de Currents.
- Notificaciones
- La API de Reports proporciona notificaciones que te permiten estar atento a eventos, como el siguiente cambios en los recursos. Cuando observas un recurso que cambia, la API de informes te envía una notificación. Para obtener más información sobre la configuración y recibir notificaciones de la API de Reports, consulta la guía para Recibir notificaciones push.
Próximos pasos
Para aprender sobre la API de Reports 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. Puedes continúa en esta sección para leer información general sobre la configuración tu cuenta.
El 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 la 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 las Centro de ayuda para administradores de Google Workspace.