Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 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
Para obtener información 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 de la izquierda. También puedes continuar por esta sección para leer información general sobre la configuración de tu cuenta.
En la sección de autorización, se muestra cómo usar 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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-29 (UTC)"],[],[],null,["# Reports API Overview\n\nThe Reports API is a RESTful API you can use to access information about the\nGoogle Workspace activities of your users. The Reports API is part of the Admin SDK API.\n\nThe Reports API provides two types of reports:\n\n- **Activity** reports, which report events for a specific application or service, such as Google Drive or the Admin console.\n- **Usage** reports, which list workspace events caused by users.\n - **Customer** usage reports list events for all users in your domain.\n - **User** usage reports list events organized by user.\n\nFollowing is a list of common terms used in the Reports API:\n\n*Activity reports*\n\n: Activity reports list information for activities in a specific Google Workspace\n application or service. Activity reports include the date, time, user, and type\n of activity. The\n [API reference](/workspace/admin/reports/v1/reference)\n contains a complete list of activity reports and the information they include.\n Here are some example activity reports, listed by application or service:\n\n- [Admin activity reports](/workspace/admin/reports/v1/guides/manage-audit-admin) show activities done by administrators using the Admin console. For example, you could get a list of all the times administrators changed a user's name using the Admin console.\n- [Google Drive activity reports](/workspace/admin/reports/v1/guides/manage-audit-drive) list how your domain's users edit and view their Drive documents. For example, you can get a list of a particular user's activity on Drive.\n- [Login activity reports](/workspace/admin/reports/v1/guides/manage-audit-login) provide information on when your account's users log in and out of their accounts. You can, for example, get a report of all the logins for your domain over a particular time period.\n- [Mobile activity reports](/workspace/admin/reports/v1/guides/manage-audit-mobile) show activities using mobile devices managed by [Google Mobile Management](https://workspace.google.com/products/admin/endpoint/). For example, you can get a notification when users register a new device.\n- [OAuth Token activity reports](/workspace/admin/reports/v1/guides/manage-audit-tokens) list events when your users have given or revoked authorization tokens used by third-party websites and applications. You can use the Reports API to get a list of all third-party access to a user's Google Workspace data.\n\n*Usage reports*\n\n: Usage reports provide information about Google Workspace events in your domain.\n You can use the API to request specific information about users.\n\n- [Customers usage reports](/workspace/admin/reports/v1/guides/manage-usage-customers) list detailed application and service activities in your account. This usage information is organized by application type and contains information specific to that application.\n- [Users usage reports](/workspace/admin/reports/v1/guides/manage-usage-users) show activities by your account's users. These reports can be customized and filtered for specific usage information. This usage information is organized by application type and contains information specific to that application.\n- [Entities usage reports](/workspace/admin/reports/v1/guides/manage-usage-entities) list activities related to entities used by your account's users in the Currents application.\n\n*Notifications*\n: The Reports API provides notifications that let you watch for events, such as\n changes to resources. When you're watching a resource and that resource changes,\n the Reports API sends you a notification. For more information on setting up and\n receiving notifications from the Reports API, see the guide to\n [Receiving Push Notifications](/workspace/admin/reports/v1/guides/push).\n\nNext steps\n----------\n\n- To learn about the Reports API and see it work, use a Quickstart,\n which are listed by programming language on the left navigation bar. You can\n also continue through this section to read general information about setting up\n your account.\n\n- The\n [authorization](/workspace/admin/reports/v1/guides/authorizing)\n section shows you how to use OAuth 2.0 access tokens to obtain user data from\n Google Workspace applications and services.\n\n- To find the details of a specific resource type or method, see the\n [API reference](/workspace/admin/reports/v1/reference).\n\n- For more information, see the\n [Admin SDK API issue tracker](https://issuetracker.google.com/savedsearches/566232),\n the\n [Google Workspace Developers blog](https://cloud.google.com/blog/topics/workspace-developers),\n and the\n [Google Workspace Admin help center](https://support.google.com/a)."]]
