Descripción general de la API de informes

La API de Reports es una API de REST 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 para una aplicación o un servicio específicos, como Google Drive o la Consola del administrador
  • Informes de uso, en los que se enumeran los eventos del espacio de trabajo causados por los usuarios
    • Los informes de uso del cliente enumeran los eventos de todos los usuarios de tu dominio.
    • Los informes de uso de usuarios 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 muestra información sobre 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, organizados por aplicación o servicio:

  • Los informes de actividad del administrador 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.
  • 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 en particular en Drive.
  • Los informes de actividad de acceso proporcionan información sobre cuándo los usuarios de tu cuenta acceden a sus cuentas y salen de ellas. 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 con los 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 registran los eventos cuando tus usuarios otorgan o revocan tokens de autorización que usan sitios web y aplicaciones 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.

  • Los informes de uso de los clientes enumeran las actividades detalladas de las aplicaciones y los servicios en tu cuenta. Esta información de uso se organiza por tipo de aplicación y contiene información específica de cada 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 cada aplicación.
  • Los informes de uso de entidades 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 supervisar eventos, como cambios en los recursos. Cuando miras 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 para recibir notificaciones push.

Próximos pasos