Présentation de l'API Google Drive Activity

Ce document fournit une présentation de l'API Google Drive Activity.

L'API Drive Activity vous permet d'interroger les événements récents. Vous pouvez récupérer un historique détaillé de toutes les activités, y compris des informations précises sur chaque événement. Cela est utile pour les tâches telles que les audits, car vous pouvez récupérer des activités précises incluant les informations ActionDetail, Actor et Target.

L'API Drive Activity se compose de la ressource DriveActivity, qui représente les modifications apportées aux objets du Google Drive d'un utilisateur, et de la méthode activity.query, qui vous permet de récupérer des informations sur ces modifications.

Requête

Votre application demande les données d'activité d'un utilisateur à l'aide de la méthode activity.query. Vous pouvez demander l'activité d'un élément Drive spécifique ou de tout ce qui se trouve dans un dossier Drive. Pour une requête donnée, vous pouvez choisir de limiter la réponse à l'aide d'un filtre tel qu'une plage de dates ou un type d'action. Vous pouvez également choisir de consolider l'activité dans la réponse. Pour en savoir plus, consultez Envoyer des requêtes dans l'API Google Drive Activity.

Réponse

La réponse contient une liste d'activités correspondant aux paramètres fournis, où une ressource DriveActivity représente chaque activité :

Explication du message du corps de réponse de l'API Drive Activity.
Figure 1. Explication du message du corps de réponse de l'API Drive Activity.

Une ressource DriveActivity est une collection d'objets Action, chacun étant autonome comme un événement. Un Action inclut un ActionDetail (tel que Create ou Edit), un Actor (tel que User ou Administrator), un Target (tel que DriveItem ou Drive), et un Timestamp ou un TimeRange.

Une ressource DriveActivity contient également des informations récapitulatives, telles que chaque Actor et Target de toutes les actions, un Timestamp ou TimeRange unifié, ainsi que le ActionDetail le plus important ou le plus représentatif du Action.

Pour en savoir plus, consultez le modèle de données de l'API Drive Activity.

Visibilité de l'historique d'activité

Il est possible que certaines activités sur Drive ne soient pas signalées lorsque vous utilisez l'API Drive Activity. La façon dont l'API signale une modification apportée à un objet dépend de la visibilité de cette modification ou des informations la concernant pour l'utilisateur authentifié dans votre application.

La visibilité dépend des autorisations définies pour l'objet. Voici quelques scénarios dans lesquels des fichiers et des dossiers sont partagés dans Drive :

  • Si un auteur partage un document, l'historique d'activité du document est visible à la fois par le créateur et par les utilisateurs avec lesquels il a été partagé.

  • Si un document a été partagé avec un utilisateur, puis rendu privé, il peut consulter l'historique complet des activités pour la période où il y avait accès, mais pas après la restriction des autorisations.

  • Si un document n'a jamais été partagé avec un utilisateur, celui-ci ne peut pas consulter l'historique des activités.