L'API Google Drive Activity comprend la ressource DriveActivity
, qui représente les modifications apportées aux objets dans le Google Drive d'un utilisateur, et 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 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 par contraintes, telles que la période ou le type d'action, et 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
(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 chaque Actor
et Target
de toutes les actions, un Timestamp
ou TimeRange
unifié, et l'élément 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 enregistrées lorsque vous utilisez cette API. La possibilité pour l'API Drive Activity de signaler une modification donnée à un objet varie selon que la modification ou les informations la concernant sont visibles par l'utilisateur authentifié dans votre application.
La visibilité est basée sur les 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é de ce document 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é tant qu'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 n'a accès à aucun historique d'activité.
Commencer
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 découvrir les activités dans la documentation de référence de l'API.