Pour les applications Google Drive qui doivent suivre les modifications apportées aux éléments dans Drive, la collection Changes offre un moyen efficace de détecter les modifications. La collection fonctionne en fournissant l'état actuel de chaque élément, si et seulement si l'élément a changé depuis un moment donné.
Google Drive conserve un journal des modifications pour chaque utilisateur et chaque Drive partagé. Chacun d'eux dispose de son propre enregistrement des modifications apportées aux éléments qui l'intéressent.
Pour suivre les modifications apportées à tous les éléments visibles par un utilisateur, il est nécessaire de relire le journal des modifications de l'utilisateur et les journaux des modifications de tous les lecteurs partagés dont il est membre.
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 fournit pas de delta entre les révisions. Les applications qui ont besoin de savoir quelles propriétés ont changé doivent conserver l'état précédemment connu de l'élément et le comparer.
É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.
Tombstones
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'ID de l'élément est disponible dans l'entrée de modification.
Suivre les Drive partagés
Chaque Drive partagé dispose de son propre journal des modifications. Même si un utilisateur est 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 est apparu à un moment donné dans le journal des modifications de l'utilisateur, la relecture du journal des modifications de l'utilisateur seul ne mettra pas à jour correctement l'état du fichier. Vous devez plutôt relire le journal des modifications du Drive partagé pour capturer toutes les modifications.
Informations incluses dans 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 qu'aux fichiers de son corpus. Pour en savoir plus sur les corpus, consultez Présentation des modifications et des révisions.
Les modifications apportées aux Drives partagés s'affichent dans le journal des modifications de l'utilisateur :
- L'utilisateur devient membre d'un Drive partagé.
- L'utilisateur n'est plus membre d'un Drive partagé.
- Une modification directement pertinente a été apportée à un Drive partagé dont l'utilisateur est 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é s'affiche 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 apportées aux éléments contenus dans le Drive partagé lorsqu'il en devient membre.
Les membres d'un Drive partagé peuvent voir les é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 se voit accorder l'accès à des éléments individuels d'un Drive partagé, les modifications apportées à ces éléments sont suivies dans son journal des modifications. Cela correspond aux éléments Drive non partagés qui sont partagés directement avec les utilisateurs.
Modifications qui apparaissent 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 informations suivantes :
- Toute modification apportée au Drive partagé lui-même, comme l'ajout ou la suppression d'un membre
- Apporter des modifications directes aux éléments contenus dans le Drive partagé.
Synchroniser les autorisations et les fonctionnalités
Les modifications apportées aux autorisations d'un Drive partagé ou des éléments qu'il contient ne sont répercutées que sur l'élément lui-même. Bien que tous les enfants directs ou indirects de cet élément héritent de cette modification, il n'y aura pas d'entrée distincte dans le journal des modifications pour chacun de ces éléments. Les clients doivent propager les nouvelles fonctionnalités ou récupérer chaque élément si un parent a changé afin de reconstruire complètement les modifications.