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 SDK Admin.
L'API Reports propose deux types de rapports:
- Les rapports Activité, qui enregistrent les événements d'une application ou d'un service spécifique, comme Google Drive ou la console d'administration.
- Les rapports Utilisation, qui répertorient les événements de l'espace de travail causés par les utilisateurs.
- Les rapports sur l'utilisation client répertorient les événements pour tous les utilisateurs de votre domaine.
- Les rapports sur l'utilisation des utilisateurs listent les événements organisés par utilisateur.
Vous trouverez ci-dessous une liste des termes couramment utilisés dans l'API Reports:
- Rapports sur l'activité
Les rapports sur l'activité répertorient les informations sur les activités d'une application ou d'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 une liste complète des rapports sur l'activité et les informations qu'ils incluent. Voici quelques exemples de rapports sur l'activité, classés par application ou service:
- Les rapports sur l'activité des administrateurs indiquent 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 de l'activité d'un utilisateur donné dans Drive.
- Les rapports sur l'activité de connexion indiquent quand les utilisateurs de votre compte se connectent et se déconnectent. Vous pouvez, par exemple, obtenir un rapport sur toutes les connexions de votre domaine sur une période donnée.
- Les rapports sur l'activité mobile affichent les activités effectuées à l'aide d'appareils mobiles gérés par Gestion des appareils mobiles Google. Par exemple, vous pouvez recevoir une notification lorsque des utilisateurs enregistrent un nouvel appareil.
- Les rapports sur l'activité des jetons OAuth répertorient les événements lorsque vos utilisateurs ont accordé ou révoqué des jetons d'autorisation utilisés par des sites Web et des 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 sur l'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 des clients listent les activités détaillées des applications et des services dans votre compte. Ces informations d'utilisation sont organisées par type d'application et contiennent des informations spécifiques à cette application.
- Les rapports sur l'utilisation des utilisateurs indiquent les activités des utilisateurs de votre compte. Vous pouvez personnaliser et filtrer ces rapports pour obtenir des informations d'utilisation spécifiques. Ces informations d'utilisation sont organisées par type d'application et contiennent des informations spécifiques à cette application.
- Les rapports sur l'utilisation des entités répertorient 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 des événements, tels que les modifications apportées aux ressources. Lorsque vous surveillez une ressource et qu'elle change, l'API Reports vous envoie une notification. Pour en savoir plus sur la configuration et la réception de notifications de l'API Reports, consultez le guide sur la réception de notifications push.
Étapes suivantes
Pour en savoir plus sur l'API Reports et la voir fonctionner, utilisez un démarrage rapide, qui est listé par langage de programmation dans la barre de navigation de gauche. Vous pouvez également poursuivre la lecture de cette section pour obtenir des informations générales sur la configuration de votre compte.
La section Autorisation explique comment utiliser des jetons d'accès OAuth 2.0 pour obtenir des données utilisateur à partir des applications et services Google Workspace.
Pour obtenir des informations sur un type de ressource ou une méthode spécifique, consultez la documentation de référence de l'API.
Pour en savoir plus, consultez le outil de suivi des problèmes de l'API du SDK Admin, le blog Google Workspace Developers et le Centre d'aide Google Workspace Admin.