L'API Google Drive Activity se compose de la ressource DriveActivity, qui représente les modifications apportées aux objets dans le Google Drive d'un utilisateur, et de la méthode activity.query, qui vous permet de récupérer des informations sur ces modifications.
Demande
Votre application demande les données d'activité d'un utilisateur à l'aide de la méthode activity.query. Vous pouvez demander une activité pour un élément Drive spécifique ou pour tout ce qui se trouve dans un dossier Drive. Pour une requête donnée, vous pouvez choisir de limiter la réponse en fonction de contraintes telles qu'une période 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 Drive Activity.
Réponse
La réponse à une requête est une liste d'activités correspondant aux paramètres donnés, où une ressource DriveActivity représente chaque activité:
Une ressource DriveActivity est un ensemble d'objets Action, chacun étant autonome comme un événement. Un Action inclut un ActionDetail (tel que Create ou Edit), un Actor (par exemple, User ou Administrator), un Target (comme DriveItem ou Drive) et un Timestamp ou TimeRange.
Une ressource DriveActivity contient également des informations récapitulatives, telles que tous les Actor et Target de toutes les actions, un Timestamp ou un TimeRange unifié, ainsi que l'ActionDetail le plus important ou le plus représentatif de 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 consignées lorsque vous utilisez cette API. Le fait que l'API Drive Activity signale une modification donnée dans un objet varie selon que la modification, ou des informations la concernant, sont visibles par l'utilisateur authentifié dans votre application.
La visibilité dépend des autorisations définies pour l'objet. Il existe plusieurs scénarios de partage de fichiers et de dossiers dans Drive:
- Si un auteur partage un document, l'historique d'activité de celui-ci est visible non seulement par le créateur, mais également par les utilisateurs authentifiés avec lesquels il a été partagé.
- Si un document a été partagé avec un utilisateur, puis rendu privé, l'utilisateur authentifié peut voir tout l'historique d'activité lorsqu'il y avait accès et que les autorisations sont désormais limitées.
- Si un document n'a jamais été partagé avec un utilisateur, celui-ci ne peut voir aucun historique d'activité.
Premiers pas
Pour tirer le meilleur parti de l'API Drive Activity, commencez par intégrer votre application à l'API Google Drive. Pour commencer à utiliser l'API Drive Activity, découvrez comment créer un projet et autoriser les requêtes. Vous pouvez également vous plonger directement dans la documentation de référence de l'API pour en savoir plus sur les activités.