Descripción general de la API de informes

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 un servicio específicos, como Google Drive o la Consola del administrador.
  • Informes de uso, que enumeran los eventos del lugar de trabajo que causaron los usuarios
    • Los informes de uso del cliente enumeran los eventos de todos los usuarios de tu dominio.
    • Los informes de uso de los 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 informes:

Informes de actividad

Los informes de actividad enumeran datos de las actividades de 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. A continuación, se muestran algunos ejemplos de informes de actividad, ordenados por aplicación o servicio:

  • Los informes de actividad del administrador muestran las actividades que realizan los administradores por medio de la Consola del administrador. Por ejemplo, puedes obtener una lista de todas las veces en 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 determinado.
  • Los informes de actividad móvil muestran 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.
  • En los informes de actividad de tokens de OAuth, se enumeran los eventos cuando los usuarios otorgaron o revocaron tokens de autorización que usan los sitios web y las aplicaciones 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 enumeran las actividades detalladas de la aplicación y el servicio de 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 está organizada por tipo de aplicación y contiene datos específicos de esa aplicación.
  • Los informes de uso de entidades enumeran las actividades relacionadas con las entidades que utilizan 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. Para obtener más información sobre cómo configurar y recibir notificaciones de la API de Reports, consulta la guía Recibe notificaciones push.

Próximos pasos