Présentation de l'API Google Drive Activity

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 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é:

Explication de l'activité Drive.

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. Que 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 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