L'API Google Drive Activity se compose de la ressource DriveActivity, qui représente les modifications apportées aux objets de 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 limiter la réponse en fonction de 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 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 (par exemple, Create ou Edit), un Actor (par exemple, User ou Administrator), un Target (par exemple, 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 TimeRange unifié, et 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 des activités
Il est possible que certaines activités sur Drive ne soient pas enregistrées lorsque vous utilisez cette API. L'API Drive Activity signale-t-elle une modification donnée d'un objet ? Cela dépend si la modification ou les 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 lorsque des fichiers et des dossiers sont partagés dans Drive:
- Si un auteur partage un document, l'historique des activités 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 rendu privé, l'utilisateur authentifié peut voir l'historique de toutes les activités pendant qu'il avait accès au document 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é.
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 plonger directement dans le sujet et en savoir plus sur les activités dans la documentation de référence de l'API.