Présentation de l'API Reports

L'API Reports est une API RESTful qui vous permet d'accéder à des informations sur les activités Google Workspace de vos utilisateurs. L'API Reports fait partie de l'API Admin SDK.

L'API Reports propose deux types de rapports:

  • Les rapports Activité, qui signalent les événements d'une application ou d'un service spécifique, tels que Google Drive ou la console d'administration.
  • Les rapports Utilisation, qui répertorient les événements d'espace de travail causés par les utilisateurs.
    • Les rapports d'utilisation Clients répertorient les événements de tous les utilisateurs de votre domaine.
    • Les rapports sur l'utilisation de l'utilisateur répertorient les événements organisés par utilisateur.

Voici une liste des termes couramment utilisés dans l'API Reports:

Rapports d'activité

Les rapports d'activité répertorient des informations sur les activités d'une application ou d'un service Google Workspace spécifique. Les rapports d'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 d'activité et les informations qu'ils incluent. Voici quelques exemples de rapports d'activité, répertoriés par application ou par service:

  • Les rapports sur l'activité d'administration affichent les activités effectuées par les administrateurs à l'aide de la console d'administration. Par exemple, vous pouvez obtenir la liste de toutes les modifications du nom d'un utilisateur par les administrateurs dans la console d'administration.
  • Les rapports d'activité Google Drive indiquent comment les utilisateurs de votre domaine modifient et affichent leurs documents Drive. Par exemple, vous pouvez obtenir la liste de l'activité d'un utilisateur particulier sur Drive.
  • Les rapports d'activité de connexion fournissent des informations sur le moment où les utilisateurs de votre compte se connectent à leur compte et se déconnectent. Vous pouvez, par exemple, obtenir un rapport sur toutes les connexions à votre domaine sur une période donnée.
  • Les rapports sur l'activité mobile indiquent les activités effectuées sur les appareils mobiles gérés par Google Mobile Management. Par exemple, vous pouvez recevoir une notification lorsque les 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 applications et des sites Web 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 de votre domaine. Vous pouvez utiliser l'API pour demander des informations spécifiques sur les utilisateurs.

  • Les rapports d'utilisation des clients répertorient en détail les activités liées aux applications et aux 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 ces rapports et les filtrer pour afficher 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 que celle-ci est modifiée, l'API Reports vous envoie une notification. Pour en savoir plus sur la configuration et la réception de notifications à partir de l'API Reports, consultez le guide Recevoir des notifications push.

Étapes suivantes