Änderungen und Überarbeitungen

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 Ressource Revisions wird die Überarbeitung auf „Niemals beibehalten“ festgelegt. Außerdem können Sie revisions.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