Pour les applications Google Drive qui doivent suivre les modifications apportées aux éléments dans Drive, la collection "Modifications" permet de détecter efficacement les modifications. La collection fournit 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é. Chacune d'elles possède son propre enregistrement des modifications apportées aux éléments qui les intéressent.
Pour suivre les modifications apportées à tous les éléments visibles par un utilisateur, le journal des modifications de l'utilisateur et les journaux des modifications de tous les Drive partagés dont l'utilisateur est membre doivent être lus.
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 doivent 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, des 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 des é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 le journal des modifications de l'utilisateur. Si un fichier appartient à un Drive partagé, même s'il figurait encore dans le journal des modifications de l'utilisateur à un moment donné, la lecture du journal des modifications de l'utilisateur ne met pas à jour correctement l'état du fichier. Vous devez plutôt lire 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 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 à un Drive partagé s'affichent dans l'historique 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 sur 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 le journal des modifications de l'utilisateur. Cela implique un accès à tous les éléments du Drive partagé. L'utilisateur ne reçoit pas les modifications apportées aux éléments du 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 non-membre est autorisé à accéder à des fichiers individuels d'un Drive partagé, les modifications apportées à ces éléments sont suivies dans le journal des modifications de l'utilisateur. Il en va de même pour les éléments Drive non partagés qui sont partagés directement avec des 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 partagé, 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
- Apportez des modifications directes aux éléments contenus dans le Drive partagé.
Autorisations et fonctionnalités de synchronisation
Les modifications apportées aux autorisations d'un Drive partagé ou des éléments d'un Drive partagé ne sont reflétées que sur l'élément lui-même. Bien que tous les enfants directs ou indirects de cet élément héritent de ce changement, 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 à nouveau chaque élément si un parent a changé afin de reconstruire complètement les modifications.