Présentation de l'API Reports

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 appareils mobiles affichent les activités effectuées sur les appareils mobiles gérés par la 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 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