Pour les applications Google Drive qui doivent suivre les modifications apportées aux fichiers, la collection changes
constitue un moyen efficace de détecter toutes les modifications de fichiers, y compris celles qui sont partagées avec un utilisateur. Si le fichier a été modifié, la collection fournit l'état actuel de chaque fichier.
Obtenir le jeton de la page d'accueil
Pour demander le jeton de page pour l'état actuel du compte, utilisez changes.getStartPageToken
.
Stockez et utilisez ce jeton dans votre appel initial à changes.list
.
Pour récupérer le jeton de la page actuelle, procédez comme suit:
Java
Python
PHP
.NET
Node.js
Obtenir les modifications
Pour récupérer la liste des modifications apportées à l'utilisateur actuellement connecté, envoyez une requête GET
à la collection changes
, comme indiqué dans changes.list
.
Les entrées de la collection changes
sont dans l'ordre chronologique (les modifications les plus anciennes apparaissent en premier). Les paramètres de requête includeRemoved
et restrictToMyDrive
déterminent si la réponse doit inclure les éléments supprimés ou partagés.
Java
Python
PHP
.NET
Node.js
La collection changes
dans la réponse peut contenir un nextPageToken
. Si nextPageToken
est répertorié, il peut être utilisé pour rassembler la page de modifications suivante. S'il n'est pas répertorié, l'application cliente doit stocker newStartPageToken
dans la réponse pour une utilisation ultérieure. Une fois le jeton de page stocké, l'application cliente est prête à interroger à nouveau les futurs changements.
Recevoir les notifications
Utilisez la méthode changes.watch
pour vous abonner aux mises à jour du journal des modifications. Les notifications ne contiennent pas de détails sur les modifications. Elles indiquent plutôt que de nouvelles modifications sont disponibles. Pour récupérer les modifications réelles, interrogez le flux de modifications comme décrit dans la section Obtenir les modifications.
Pour en savoir plus, consultez Notifications en cas de modification des ressources.