Suivre les modifications apportées aux utilisateurs et aux Drive partagés

Pour les applications Google Drive qui doivent suivre les modifications apportées aux éléments Drive, la collection des modifications constitue un moyen efficace de détecter les modifications. La collecte consiste à fournir l'état actuel de chaque élément, si et seulement s'il a changé depuis un moment donné.

Google Drive conserve un journal des modifications pour chaque utilisateur et Drive partagé. Chacun d'eux possède son propre enregistrement des modifications apportées aux éléments qui l'intéressent.

Pour suivre les modifications de tous les éléments visibles par un utilisateur, le journal des modifications de l'utilisateur et ceux de tous les Drive partagés dont l'utilisateur est membre doivent être relus.

Activer les entrées de modification

Une entrée de modification représente l'état du fichier ou du Drive partagé à un moment donné. Une modification ne crée pas de delta entre les révisions. Les applications qui ont besoin de savoir quelles propriétés ont été modifiées doivent conserver l'état précédemment connu de l'élément et effectuer une comparaison.

Étant donné que les modifications représentent l'état actuel d'un élément, les entrées de modification individuelles peuvent être invalidées et remplacées par une entrée de modification plus récente pour l'élément correspondant.

Pierres tombales

Les entrées de modification pour les éléments qui ne sont plus disponibles pour un utilisateur sont marquées comme deleted dans l'entrée de modification. Seul l'identifiant de l'élément est disponible dans l'entrée de modification.

Suivre des Drive partagés

Chaque Drive partagé possède son propre journal des modifications. Même si un utilisateur peut être membre d'un Drive partagé, certaines modifications ne sont reflétées que dans le journal des modifications du Drive partagé, et jamais dans celui de l'utilisateur. Si un fichier appartient à un Drive partagé, même s'il apparaît encore dans le journal des modifications de l'utilisateur à un moment donné, la relecture seule du journal des modifications de l'utilisateur ne permettra pas de mettre correctement à jour son état. À la place, vous devez relire le journal des modifications du Drive partagé pour capturer toutes les modifications.

Que contient le journal des modifications d'un utilisateur ?

Le journal des modifications d'un utilisateur inclut les modifications apportées aux Drive partagés dont il est membre, ainsi que les modifications apportées aux fichiers du corpus de l'utilisateur. Pour en savoir plus sur les corpus, consultez la section Présentation des modifications et des révisions.

Les modifications apportées aux Drive partagés apparaissent dans le journal des modifications de l'utilisateur:

  • L'utilisateur devient membre d'un Drive partagé.
  • L'utilisateur n'est plus membre du Drive partagé.
  • Une modification directement pertinente est apportée à un Drive partagé dont l'utilisateur est un membre, par exemple :
    • Le niveau d'accès de l'utilisateur à ce Drive partagé a changé.
    • Le Drive partagé est renommé.

Lorsqu'un utilisateur devient membre d'un Drive partagé, un seul événement de modification pour le Drive partagé apparaît dans son journal des modifications. Cela implique l'accès à tous les éléments du Drive partagé. L'utilisateur ne reçoit pas les modifications concernant les éléments contenus dans le Drive partagé lorsqu'il devient membre.

Les membres d'un Drive partagé peuvent voir des événements de modification des éléments d'un Drive partagé en fonction de leur utilisation. Toutefois, les applications ne doivent pas s'appuyer sur ces événements lorsque l'utilisateur est membre du Drive partagé. Utilisez plutôt le journal des modifications du Drive partagé pour suivre les modifications.

Si un utilisateur non membre dispose d'un accès à des fichiers individuels dans un Drive partagé, les modifications apportées à ces éléments sont suivies dans le journal des modifications de l'utilisateur. Cela revient à utiliser les éléments Drive non partagés qui sont partagés directement avec les utilisateurs.

Modifications apparaissant dans le journal des modifications d'un Drive partagé

Si un utilisateur est membre d'un Drive partagé, il peut accéder au journal des modifications de ce Drive, qui contient les éléments suivants:

  • Toute modification apportée au Drive partagé lui-même, comme l'ajout ou la suppression d'un membre
  • Modifications directes des éléments contenus dans le Drive partagé.

Synchronisation des autorisations et des fonctionnalités

Les modifications d'autorisation apportées à un Drive partagé ou à des éléments au sein d'un Drive partagé ne sont répercutées sur l'élément que sur celui-ci. Bien que tous les enfants directs ou indirects de cet élément hériteront de cette modification, il n'y aura pas d'entrée distincte dans le journal des modifications pour chacun de ces éléments. Pour reconstruire entièrement les modifications, les clients doivent soit propager les nouvelles capacités, soit récupérer à nouveau chaque élément si un parent a changé.