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 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 Workspace causés par les utilisateurs.
    • Les rapports d'utilisation du Client répertorient les événements de tous les utilisateurs de votre domaine.
    • Les rapports d'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é fournissent des informations sur les activités liées à une application ou à 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é, classés par application ou service:

  • Les rapports sur les activités d'administration présentent les activités effectuées par les administrateurs depuis la console d'administration. Par exemple, vous pouvez obtenir la liste de toutes les modifications du nom d'un utilisateur effectuées 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 "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 sur toutes les connexions à 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 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. L'API Reports vous permet d'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 selon des informations spécifiques sur l'utilisation. 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 est modifiée, 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 Recevoir des notifications push.

Étapes suivantes