Ce document fournit une présentation de l'API Google Drive Activity.
L'API Drive Activity vous permet d'interroger les événements récents. Vous pouvez récupérer un historique détaillé de toutes les activités, y compris des informations précises sur chaque événement. Cela est utile pour les tâches telles que les audits, car vous pouvez récupérer des activités précises qui incluent les informations ActionDetail, Actor et Target.
L'API Drive Activity se compose de la
DriveActivity ressource, qui représente
les modifications apportées aux objets du Google Drive d'un utilisateur, et de la
activity.query méthode, 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 activity.query méthode. Vous pouvez demander l'activité pour un élément Drive spécifique ou pour tout ce qui est contenu dans un dossier Drive. Pour une requête donnée, vous pouvez choisir de limiter la
réponse à l'aide d'un filtre tel que la période
ou le type d'action, et vous pouvez choisir de regrouper l'activité consolidée dans la réponse. Pour en savoir plus,
consultez Envoyer des requêtes dans l'API Google Drive Activity.
Réponse
La réponse contient une liste d'activités correspondant aux paramètres donnés, où
une DriveActivity ressource représente chaque
activité :
Une ressource DriveActivity est une collection d'
Action objets, chacun étant autonome
comme un événement. Une Action inclut un ActionDetail (tel que Create ou Edit), un Actor (tel que User ou Administrator), une Target (telle que DriveItem ou Drive), et un
Timestamp
ou une TimeRange.
Une ressource DriveActivity contient également des informations récapitulatives, telles que chaque
Actor et Target de toutes les actions, un Timestamp ou une TimeRange unifiés,
ainsi que le ActionDetail le plus important ou le plus représentatif de l'Action.
Pour en savoir plus, consultez le modèle de données de l'API Drive Activity.
Visibilité de l'historique des activités
Certaines activités sur Drive peuvent ne pas être signalées lorsque vous utilisez l'API Drive Activity. Le fait que l'API signale ou non une modification donnée 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é est basée sur les 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 des activités de ce document est visible à la fois par le créateur et par les utilisateurs avec lesquels il a été partagé.
Si un document a été partagé avec un utilisateur, puis rendu privé, l'utilisateur peut consulter l'historique de toutes les activités de la période pendant laquelle il y avait accès, mais pas après la restriction des autorisations.
Si un document n'a jamais été partagé avec un utilisateur, celui-ci ne peut pas consulter l'historique des activités.
Articles associés
- Pour tirer le meilleur parti de l'API Drive Activity, commencez par intégrer votre application à l'API Google Drive
- Pour en savoir plus sur le développement avec les API Google Workspace, y compris sur la création d'un projet ou la gestion de l'authentification et des autorisations, consultez Développer sur Google Workspace.
- Pour en savoir plus sur les activités, consultez la documentation de référence de l'API.