Für Google Drive-Anwendungen, die Änderungen an Dateien verfolgen müssen, bietet die Sammlung changes
eine effiziente Möglichkeit, alle Dateiänderungen zu erkennen, auch solche, die für einen Nutzer freigegeben wurden. Wenn sich die Datei geändert hat, liefert die Sammlung den aktuellen Status jeder Datei.
Startseitentoken abrufen
Mit changes.getStartPageToken
fordern Sie das Seitentoken für den aktuellen Status des Kontos an.
Speichern und verwenden Sie dieses Token beim ersten Aufruf von changes.list
.
So rufen Sie das Token der aktuellen Seite ab:
Java
Python
PHP
.NET
Node.js
Änderungen abrufen
Wenn Sie die Liste der Änderungen für den aktuell angemeldeten Nutzer abrufen möchten, senden Sie eine GET
-Anfrage an die Sammlung changes
, wie in changes.list
beschrieben.
Die Einträge in der Sammlung changes
sind in chronologischer Reihenfolge sortiert (die ältesten Änderungen werden zuerst angezeigt). Die Abfrageparameter includeRemoved
und restrictToMyDrive
bestimmen, ob die Antwort entfernte oder freigegebene Elemente enthalten soll.
Java
Python
PHP
.NET
Node.js
Die Sammlung changes
in der Antwort kann eine nextPageToken
enthalten. Wenn nextPageToken
aufgeführt ist, kann damit die nächste Seite mit Änderungen erfasst werden. Ist dies nicht der Fall, sollte die Clientanwendung den newStartPageToken
zur späteren Verwendung in der Antwort speichern. Wenn das Seitentoken gespeichert ist, kann die Clientanwendung eine erneute Abfrage für zukünftige Änderungen ausführen.
Benachrichtigungen erhalten
Verwenden Sie die Methode changes.watch
, um Aktualisierungen im Änderungsprotokoll zu abonnieren. Benachrichtigungen enthalten keine Details zu den Änderungen. Stattdessen weisen sie darauf hin, dass neue Änderungen verfügbar sind. Wenn Sie die tatsächlichen Änderungen abrufen möchten, fragen Sie den Änderungsfeed wie unter Änderungen abrufen beschrieben ab.
Weitere Informationen finden Sie unter Benachrichtigungen für Ressourcenänderungen.