La API de Reports es una API 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 del SDK de Admin.
La API de Reports proporciona dos tipos de informes:
- Informes de actividad, que registran eventos de una aplicación o un servicio específicos, como Google Drive o la Consola del administrador.
- Informes de uso, que enumeran los eventos del espacio de trabajo que causaron los usuarios
- En los informes de uso de clientes, se enumeran los eventos de todos los usuarios de tu dominio.
- En los informes de uso de Usuario, se enumeran los eventos organizados por usuario.
A continuación, se incluye una lista de términos comunes que se usan en la API de Reports:
- Informes de actividad
En los informes de actividad, se enumera la información de las actividades en una aplicación o un servicio específicos 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, enumerados por aplicación o servicio:
- En los informes de actividad del administrador, se muestran las actividades que realizan los administradores con la Consola del administrador. Por ejemplo, puedes obtener una lista de todas las veces que los administradores cambiaron el nombre de un usuario con la Consola del administrador.
- En los informes de actividad de Google Drive, se indica 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 de tu cuenta acceden a ella y salen de ella. Por ejemplo, puedes obtener un informe de todos los accesos a tu dominio durante un período determinado.
- Los informes de actividad en dispositivos móviles muestran las actividades que se realizan 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 registran un dispositivo nuevo.
- En los informes de actividad de tokens de OAuth, se enumeran los eventos en los que tus usuarios otorgaron o revocaron tokens de autorización que usan sitios web y aplicaciones de terceros. Puedes usar la API de Reports para obtener una lista de todo el acceso 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 enumeran las actividades detalladas de la aplicación y el 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 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 se organiza por tipo de aplicación y contiene información específica de esa aplicación.
- En los 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 Reports proporciona notificaciones que te permiten detectar eventos, como cambios en los recursos. Cuando observas un recurso y este cambia, la API de Reports te envía una notificación. Para obtener más información sobre cómo configurar y recibir notificaciones de la API de Reports, consulta la guía sobre cómo recibir 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 enumera por lenguaje de programación en la barra de navegación izquierda. También puedes seguir leyendo esta sección para obtener información general sobre la configuración de tu cuenta.
En la sección de 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 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 el seguimiento de problemas de la API de SDK de Admin, el blog de Google Workspace Developers y el Centro de ayuda de Admin de Google Workspace.