Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Reports est une API RESTful qui vous permet d'accéder aux informations sur les activités Google Workspace de vos utilisateurs. L'API Reports fait partie de l'API Admin SDK.
L'API Reports fournit deux types de rapports :
Les rapports sur l'activité, qui indiquent les événements pour une application ou un service spécifique, comme Google Drive ou la console d'administration.
Les rapports sur l'utilisation, qui listent les événements de l'espace de travail causés par les utilisateurs.
Les rapports sur l'utilisation par les clients listent les événements pour tous les utilisateurs de votre domaine.
Les rapports sur l'utilisation par utilisateur listent les événements organisés par utilisateur.
Vous trouverez ci-dessous une liste des termes courants utilisés dans l'API Reports :
Rapports d'activité
Les rapports sur l'activité listent les informations sur les activités dans une application ou un service Google Workspace spécifique. Les rapports sur l'activité incluent la date, l'heure, l'utilisateur et le type d'activité. La documentation de référence de l'API contient la liste complète des rapports sur l'activité et des informations qu'ils incluent.
Voici quelques exemples de rapports d'activité, classés par application ou service :
Les rapports sur l'activité des administrateurs
affichent les activités effectuées par les administrateurs dans la console d'administration. Par exemple, vous pouvez obtenir la liste de toutes les fois où les administrateurs ont modifié le nom d'un utilisateur à l'aide de la console d'administration.
Les rapports sur l'activité Google Drive indiquent comment les utilisateurs de votre domaine modifient et consultent leurs documents Drive. Par exemple, vous pouvez obtenir la liste des activités d'un utilisateur spécifique dans Drive.
Les rapports sur l'activité de connexion fournissent des informations sur les dates de connexion et de déconnexion des utilisateurs de votre compte. Par exemple, vous pouvez obtenir un rapport de toutes les connexions à votre domaine sur une période donnée.
Les rapports sur l'activité des jetons OAuth listent les événements qui se produisent lorsque vos utilisateurs ont accordé ou révoqué des jetons d'autorisation utilisés par des sites Web et applications tiers. Vous pouvez utiliser l'API Reports pour obtenir la liste de tous les accès tiers aux données Google Workspace d'un utilisateur.
Rapports sur l'utilisation
Les rapports d'utilisation fournissent des informations sur les événements Google Workspace dans votre domaine.
Vous pouvez utiliser l'API pour demander des informations spécifiques sur les utilisateurs.
Les rapports sur l'utilisation par les clients listent les activités détaillées des applications et des services dans votre compte. Ces informations sur l'utilisation sont organisées par type d'application et contiennent des informations spécifiques à cette application.
Les rapports sur l'utilisation par les utilisateurs affichent les activités des utilisateurs de votre compte. Ces rapports peuvent être personnalisés et filtrés pour obtenir des informations d'utilisation spécifiques. Ces informations sur l'utilisation sont organisées par type d'application et contiennent des informations spécifiques à cette application.
Les rapports sur l'utilisation des entités listent les activités liées aux entités utilisées par les utilisateurs de votre compte dans l'application Currents.
Notifications
L'API Reports fournit des notifications qui vous permettent de surveiller les événements, tels que les modifications apportées aux ressources. Lorsque vous regardez une ressource et que celle-ci change, l'API Reports vous envoie une notification. Pour savoir comment configurer et recevoir des notifications de l'API Reports, consultez le guide Recevoir des notifications push.
Étapes suivantes
Pour en savoir plus sur l'API Reports et la voir à l'œuvre, utilisez un démarrage rapide. Vous les trouverez listés par langage de programmation dans la barre de navigation de gauche. Vous pouvez également continuer dans cette section pour lire des informations générales sur la configuration de votre compte.
La section Autorisation vous explique comment utiliser les jetons d'accès OAuth 2.0 pour obtenir des données utilisateur à partir des applications et services Google Workspace.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]
