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 fournit deux types de rapports:

  • Les rapports Activité, qui signalent des événements pour une application ou un service spécifique, tel 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 sur l'utilisation du client répertorient les événements de tous les utilisateurs de votre domaine.
    • Les rapports sur l'utilisation par utilisateur listent les événements organisés par utilisateur.

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

Rapports d'activité

Les rapports sur les activités répertorient des informations concernant 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 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 l'activité d'administration présentent les activités réalisé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 dans la console d'administration.
  • Les rapports sur l'activité Google Drive indiquent comment les utilisateurs de votre domaine modifient et affichent leurs documents Drive. Par exemple, vous pouvez obtenir la liste des activités d'un utilisateur donné sur Drive.
  • Les rapports "Activité de connexion" indiquent quand les utilisateurs de votre compte se connectent et se déconnectent. Vous pouvez, par exemple, obtenir un rapport de toutes les connexions à votre domaine sur une période donnée.
  • Les rapports sur l'activité sur les mobiles affichent les activités 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 les utilisateurs ont attribué ou révoqué des jetons d'autorisation utilisés par des sites Web et des applications 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 d'utilisation

Les rapports d'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 sur l'utilisation des clients répertorient 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 d'utilisation présentent les activités des utilisateurs de votre compte. Ces rapports peuvent être personnalisés et filtrés en fonction d'informations 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 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 Recevoir des notifications push.

Étapes suivantes