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 tous les éléments contenus dans un dossier Drive. Pour une requête donnée, vous pouvez choisir de limiter la réponse en fonction de contraintes, telles que la période ou le type d'action. Vous pouvez également choisir d'inclure l'activité consolidée 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 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 TimeRange.
Une ressource DriveActivity contient également des informations récapitulatives, telles que toutes les valeurs Actor et Target de toutes les actions, un élément Timestamp ou TimeRange unifié, ainsi que l'élément ActionDetail le plus important ou le plus représentatif de la valeur 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 enregistrées lorsque vous utilisez cette API. Le fait que l'API Drive Activity signale une modification donnée à un objet dépend de la visibilité de la modification, ou des informations sur la modification, pour l'utilisateur authentifié dans votre application.
La visibilité dépend des autorisations définies pour l'objet. Il existe plusieurs 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 non seulement par le créateur, mais aussi par les utilisateurs authentifiés avec lesquels il a été partagé.
- Si un document a été partagé avec un utilisateur, puis privé, l'utilisateur authentifié peut consulter l'intégralité de 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 pas voir l'historique d'activité.
Premiers pas
Pour tirer le meilleur parti de l'API Drive Activity, intégrez d'abord votre application à l'API Google Drive. Pour commencer à utiliser l'API Drive Activity, découvrez comment créer un projet et autoriser des requêtes. Vous pouvez également vous plonger dans les activités de la documentation de référence sur les API.