Änderungen und Überarbeitungen

Google Drive führt automatisch einen Änderungsverlauf, mit dem Nutzer Dateiänderungen und Inhaltsüberarbeitungen im Blick behalten können. Im Überarbeitungsverlauf sehen Nutzer, welche Änderungen vorgenommen wurden, und können zu einer bestimmten Version einer Datei mit bestimmten Änderungen zurückkehren.

Die folgenden Begriffe sind für die Ressourcen für Änderungen und Überarbeitungen der Google Drive API relevant:

Access Control List (ACL)
Liste aller Berechtigungsressourcen, die mit einer Datei, einem Ordner oder einem freigegebenen Laufwerk verknüpft sind.
Ändern
Eine Änderung am Inhalt oder an den Metadaten einer Datei oder einer geteilten Ablage.
Änderungsprotokoll für Nutzer
Ein Datensatz aller Änderungen, die ein Nutzer an allen bearbeitbaren Dateien in „Meine Ablage“ vorgenommen hat, z. B. an Google Docs-, Sheets- oder Präsentationsdateien. Für Mitglieder einer geteilten Ablage enthält das Nutzeränderungsprotokoll außerdem Einträge zu Mitgliedschaften in geteilten Ablagen, Nutzerzugriffsebenen auf Elemente in dieser geteilten Ablage und Änderungen am Namen der geteilten Ablage.
Änderungsprotokoll für geteilte Ablagen
Ein Datensatz aller Änderungen an einer geteilten Ablage, z. B. Hinzufügen oder Entfernen von Nutzern, und alle Änderungen an Elementen in dieser geteilten Ablage. Eine Änderung an einem Element in einer geteilten Ablage wird sowohl im Änderungsprotokoll des Nutzers als auch im Änderungsprotokoll der geteilten Ablage angezeigt.
Änderungsprotokolleintrag
Ein Eintrag zu einer Änderung am Inhalt oder an den Metadaten einer Datei oder einer freigegebenen Ablage. Ein Eintrag im Änderungsprotokoll enthält den Nutzer, der die Änderung vorgenommen hat, den Zeitstempel und eine ID. Das Änderungsprotokoll kann jeweils nur einen Eintrag pro Datei oder geteilter Ablage enthalten. Jedes Mal, wenn sich diese Datei oder freigegebene Ablage ändert, wird für diesen Eintrag eine neue ID erstellt, die den vorherigen Eintrag ersetzt.
Revision
Eine Version der Datei, die eine Änderung des Dateiinhalts (keine Metadaten) darstellt. Auf jede Überarbeitung kann über die Überarbeitungsressource in der Drive API zugegriffen werden.
Hauptüberarbeitung
Die aktuelle Version einer Datei
Blob-Revision

Eine Version einer nicht bearbeitbaren Binärdatei, z. B. eines Bilds, Videos oder einer PDF-Datei. Wenn die Blob-Version die einzige Version der Binärdatei ist, kann sie nicht gelöscht werden. Ein neuer Blob kann als neue Version hochgeladen werden, die dann zur neuen Hauptversion dieser Datei wird.

Blob-Überarbeitungen können auf "Niemals löschen" gesetzt werden. Dies bedeutet, dass die Überarbeitung nicht automatisch dauerhaft gelöscht werden kann. Bis zu 200 Versionen können auf „Für immer aufbewahren“ gesetzt werden. Die Hauptversion wird nie automatisch gelöscht.

Alle Überarbeitungen, die nicht als „Für immer aufbewahren“ gekennzeichnet sind, können gelöscht werden. Löschbare Versionen werden in der Regel 30 Tage lang aufbewahrt, können aber auch früher gelöscht werden, wenn eine Datei 100 Versionen enthält, die nicht als „Für immer aufbewahren“ gekennzeichnet sind, und eine neue Version hochgeladen wird.

Mit dem Feld keepForever der Ressource Revisions wird die Überarbeitung auf „Für immer behalten“ festgelegt. Außerdem können Sie revisions.delete aufrufen, um eine Überarbeitung auch dann zu löschen, wenn sie als „Niemals löschen“ gekennzeichnet ist.

Überarbeitungsverlauf

Ein Datensatz mit allen Versionen einer Datei in chronologischer Reihenfolge. Wenn Sie eine Google Docs-, Google Sheets- oder Google Präsentationen-Datei ändern, wird eine neue Version erstellt. Jedes Mal, wenn sich der Inhalt ändert, erstellt Drive einen neuen Überarbeitungsverlaufseintrag für diese Datei. Diese Dateiversionen können jedoch zusammengeführt werden, 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