L'API Google 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é 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 restreindre la réponse par contraintes telles que la période ou le type d'action, et vous pouvez 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 fournis, 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 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é, et le ActionDetail le plus important ou le plus représentatif des Action.
Pour en savoir plus, consultez la page 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 cette API. Le fait que l'API Drive Activity signale ou non une modification apportée à un objet dépend de la visibilité de la 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 plusieurs scénarios de partage de fichiers et de dossiers dans Drive :
- Si un auteur partage un document, l'historique des activités de ce 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 rendu privé, l'utilisateur authentifié peut consulter l'historique des activités lorsqu'il y avait accès et voir que les autorisations sont désormais limitées.
- Si un document n'a jamais été partagé avec un utilisateur, celui-ci ne peut pas consulter l'historique des activités.
Commencer
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 les requêtes. Vous pouvez également vous lancer directement et en savoir plus sur les activités dans la documentation de référence de l'API.