Google Drive verwaltet einen automatischen Änderungsverlauf, mit dem Nutzer Dateiänderungen und Inhaltsüberarbeitungen verfolgen können. Im Überarbeitungsverlauf können Nutzer sehen, welche Änderungen vorgenommen wurden, und eine bestimmte Version einer Datei mit bestimmten Änderungen wiederherstellen.
Die folgenden Begriffe sind für die Ressourcen für Änderungen und Überarbeitungen der Google Drive API relevant:
- Access Control List (ACL)
- Die Liste aller Berechtigungsressourcen, die mit einer Datei, einem Ordner oder einer geteilten Ablage verknüpft sind.
- Ändern
- Eine Änderung am Inhalt oder an den Metadaten einer Datei oder geteilten Ablage.
- Änderungsprotokoll der Nutzer
- Ein Datensatz mit allen Änderungen, die ein Nutzer an jeder bearbeitbaren Datei in „Meine Ablage“ vorgenommen hat, z. B. an Google-Dokumenten, ‐Tabellen oder ‐Präsentationen. Für Mitglieder einer geteilten Ablage enthält das Änderungsprotokoll auch Einträge zur Mitgliedschaft in geteilten Ablagen, zu Nutzerzugriffsebenen auf Elemente in dieser geteilten Ablage und zu Namensänderungen der geteilten Ablage.
- Änderungsprotokoll für geteilte Ablagen
- Ein Datensatz mit allen Änderungen an einer geteilten Ablage, z. B. Hinzufügen oder Entfernen von Nutzern, sowie alle Änderungen an Elementen in dieser geteilten Ablage. Eine Änderung an einem Element in einer geteilten Ablage wird sowohl im Änderungsprotokoll für Nutzer als auch im Änderungsprotokoll der geteilten Ablage angezeigt.
- Änderungsprotokolleintrag
- Eintrag einer Änderung am Inhalt oder an den Metadaten einer Datei oder geteilten Ablage Ein Änderungsprotokolleintrag gibt den Nutzer, der die Änderung vorgenommen hat, den Zeitstempel und eine ID an. Im Änderungsprotokoll kann immer nur ein Eintrag pro Datei oder geteilte Ablage vorhanden sein. Jedes Mal, wenn sich diese Datei oder geteilte Ablage ändert, wird für diesen Eintrag eine neue ID erstellt, die den vorherigen Eintrag ersetzt.
- Revision
- Eine Version der Datei, die eine Änderung am Dateiinhalt darstellt (nicht an den Metadaten). Auf jede Überarbeitung kann über die Überarbeitungsressource in der Drive API zugegriffen werden.
- Hauptüberarbeitung
- Die aktuelle Version einer Datei.
- Blob-Überarbeitung
Die Version einer nicht änderbaren Binärdatei, z. B. eines Bilds, Videos oder PDF. Wenn die Blob-Überarbeitung die einzige Überarbeitung der Binärdatei ist, kann sie nicht gelöscht werden. Ein neues Blob kann als neue Überarbeitung hochgeladen werden. Dieses wird zur neuen Head-Revision dieser Datei.
Für Blob-Überarbeitungen kann „Immer beibehalten“ festgelegt werden. Das bedeutet, dass die Überarbeitung nicht automatisch dauerhaft gelöscht werden kann. Bis zu 200 Überarbeitungen können auf „Endgültig beibehalten“ festgelegt werden. Die Head-Überarbeitung wird in keinem Fall automatisch dauerhaft gelöscht.
Jede Überarbeitung mit Ausnahme der Head-Überarbeitung, die nicht als "Endgültig beibehalten" festgelegt ist, kann dauerhaft gelöscht werden. Löschbare Überarbeitungen werden in der Regel 30 Tage lang gespeichert, können aber auch früher dauerhaft gelöscht werden, wenn eine Datei 100 Überarbeitungen enthält, die nicht als "Endgültig beibehalten" gekennzeichnet sind, und eine neue Überarbeitung hochgeladen wird.
Im Feld
keepForever
der RessourceRevisions
wird die Überarbeitung auf „Niemals beibehalten“ festgelegt. Außerdem können Sierevisions.delete
aufrufen, um eine Überarbeitung zu löschen, auch wenn sie als „Niemals löschen“ markiert ist.- Überarbeitungsverlauf
Ein Datensatz aller Überarbeitungen einer Datei in chronologischer Reihenfolge. Eine Änderung an einer Datei in Google Docs, Google Tabellen oder Google Präsentationen erhält eine neue Version. Jedes Mal, wenn sich der Inhalt ändert, erstellt Drive einen neuen Überarbeitungsverlauf für diese Datei. Allerdings werden diese Editor-Dateiüberarbeitungen möglicherweise zusammengeführt, sodass in der API-Antwort möglicherweise nicht alle Änderungen an einer Datei angezeigt werden.
In diesem Video erfahren Sie, wie Sie Überarbeitungen mit der Google Drive API verwalten:
Nächste Schritte
- Informationen dazu, wo die zu verfolgende Änderung aufgezeichnet wird, finden Sie unter Zu verfolgendes Änderungsprotokoll identifizieren.
- Informationen zum Einrichten des Änderungs-Trackings für Nutzer und geteilte Ablagen finden Sie unter Änderungen für Nutzer und geteilte Ablagen verfolgen.
- Informationen zum Veröffentlichen, Herunterladen oder Abfragen von Überarbeitungen finden Sie unter Dateiüberarbeitungen herunterladen und veröffentlichen.
- Informationen zum Einrichten von Änderungsbenachrichtigungen findest du unter Push-Benachrichtigungen.