Présentation de l'API Google Drive Activity

L'API Google Drive Activity se compose de la ressource DriveActivity, qui représente les modifications apportées aux objets dans le 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 une activité pour un élément Drive spécifique ou pour tout le contenu d'un dossier Drive. Pour une requête donnée, vous pouvez choisir de limiter la réponse en fonction de contraintes telles qu'une période ou un 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é:

Explication de l'activité dans Drive.

Une ressource DriveActivity est une collection d'objets Action, chacun autonome comme un événement. Un Action inclut un ActionDetail (tel que Create ou Edit), un Actor (par exemple User ou Administrator), un Target (comme DriveItem ou Drive) et un élément Timestamp ou TimeRange.

Une ressource DriveActivity contient également des informations récapitulatives, telles que chaque Actor et Target de toutes les actions, un Timestamp ou un TimeRange unifié, et les ActionDetail les plus importants ou les plus représentatifs de 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 signalées lorsque vous utilisez cette API. Le fait que l'API Drive Activity signale une modification donnée à un objet varie selon que la modification, ou des 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 de partage de fichiers et de dossiers dans Drive:

  • Si un auteur partage un document, l'historique d'activité correspondant est visible non seulement par le créateur, mais également 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 tout l'historique de ses activités tant qu'il y avait accès et que les autorisations sont désormais limitées.
  • Si un document n'a jamais été partagé avec un utilisateur, celui-ci ne peut consulter aucun historique d'activité.

Premiers pas

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 vous plonger directement dans les activités et consulter la documentation de référence de l'API.