L'API Google Drive Activity est constituée des éléments suivants :
la ressource DriveActivity, qui
représente les modifications apportées aux objets dans le Google Drive d'un utilisateur ;
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
activity.query. Vous pouvez demander une activité
soit pour un élément Drive spécifique, soit pour tout le contenu d'un Drive
. Pour une requête donnée, vous pouvez choisir de limiter la réponse
contraintes telles que la période ou le type d'action,
vous pouvez choisir de consolider l'activité dans le
de 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 indiqués.
où un
La ressource DriveActivity représente chaque activité:
Une ressource DriveActivity est un ensemble
des objets Action, chacun étant
autonome comme un événement. Un élément Action inclut un
ActionDetail (Create, par exemple)
ou Edit), un Actor (tel que User
ou Administrator), un Target (tel que
comme DriveItem ou Drive), et
Timestamp
ou TimeRange.
Une ressource DriveActivity contient également
des informations récapitulatives, telles que
Actor et
Target de toutes les actions,
Timestamp
ou TimeRange, et soit
importantes ou représentatives
ActionDetail sur
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. Si la propriété L'API Drive Activity signale une modification donnée d'un objet varie selon que la modification, ou les informations la concernant, sont visibles par les utilisateurs authentifiés dans votre application.
La visibilité est basée sur les autorisations définies pour l'objet. Il y a plusieurs scénarios de partage de fichiers et de dossiers dans Drive:
- Si un auteur partage un document, l'historique d'activité de ce document est visible non seulement par le créateur, mais aussi par les utilisateurs authentifiés avec qui elles ont été partagées.
- Si un document a été partagé avec un utilisateur, puis rendu privé, l'utilisateur authentifié peut voir tout l'historique d'activité lorsqu'il y avait accès et que les autorisations sont désormais restreintes.
- Si un document n'a jamais été partagé avec un utilisateur, celui-ci ne peut voir aucune activité. historique.
Commencer
Pour exploiter tout le potentiel de l'API Drive Activity, intégrez votre application au API Google Drive. Pour commencer à utiliser l'API Drive Activity, Découvrez comment créer un projet et autoriser les demandes. Vous pouvez aussi vous lancer sur les activités du Documentation de référence de l'API