Änderungen und Überarbeitungen

In Google Drive wird automatisch ein Verlauf der Änderungen geführt, der Nutzern helfen kann, Dateiänderungen und Inhaltsüberarbeitungen nachzuvollziehen. Im Überarbeitungsverlauf können Nutzer sehen, welche Änderungen vorgenommen wurden, und zu einer bestimmten Version einer Datei mit bestimmten Änderungen zurückkehren.

Die folgenden Begriffe sind für die Ressourcen „Änderungen“ und „Versionen“ der Google Drive API relevant:

Access Control List (ACL)
Die Liste aller Berechtigungsressourcen, die einer Datei, einem Ordner oder einer geteilten Ablage zugeordnet sind.
Ändern
Eine Änderung am Inhalt oder an den Metadaten einer Datei oder einer geteilten Ablage.
Änderungsprotokoll für Nutzer

Eine Aufzeichnung aller Änderungen, die ein Nutzer an jeder bearbeitbaren Datei in „Meine Ablage“ vorgenommen hat, z. B. an einem Google-Dokument, einer Google Sheets- oder einer Google Präsentationen-Datei. Für Mitglieder einer geteilten Ablage enthält das Nutzeränderungsprotokoll auch Einträge zur Mitgliedschaft in der geteilten Ablage, zu Nutzerzugriffsebenen für Elemente in dieser geteilten Ablage und zu Änderungen des Namens der geteilten Ablage.

Änderungsprotokoll für geteilte Ablagen

Eine Aufzeichnung aller Änderungen an einer geteilten Ablage, z. B. das Hinzufügen oder Entfernen von Nutzern und alle Änderungen an Elementen in der 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.

Eintrag im Änderungsprotokoll

Ein Datensatz einer Änderung, die am Inhalt oder an den Metadaten einer Datei oder geteilten Ablage vorgenommen wurde. Ein Eintrag im Änderungsprotokoll enthält den Nutzer, der die Änderung vorgenommen hat, den Zeitstempel und eine ID. Im Änderungsprotokoll kann es jeweils nur einen Eintrag pro Datei oder geteilter Ablage geben. Jedes Mal, wenn sich die Datei oder geteilte Ablage ändert, wird eine neue ID für den Eintrag erstellt und der vorherige Eintrag wird ersetzt.

Revision

Eine Version der Datei, die eine Änderung am Inhalt der Datei (nicht an den Metadaten) darstellt. Auf jede Überarbeitung kann über die revisions-Ressource in der Drive API zugegriffen werden.

Head-Revision

Die aktuelle Version einer Datei. Auf die headRevisionId kann über die Ressource files in der Drive API zugegriffen werden. Die headRevisionId ist nur für Blob-Dateien in Drive verfügbar.

Blob-Revision

Eine Version einer unveränderlichen Binärdatei, etwa eines Bildes, Videos oder einer PDF-Datei. Wenn die Blob-Überarbeitung die einzige Überarbeitung der Binärdatei ist, kann sie nicht gelöscht werden. Ein neuer Blob kann als neue Revision hochgeladen werden, die zur neuen Head-Revision dieser Datei wird.

Jede Blob-Dateiüberarbeitung, die nicht die Head-Überarbeitung ist und nicht als „Niemals löschen“ gekennzeichnet ist, kann gelöscht werden. Löschbare Versionen werden in der Regel 30 Tage lang aufbewahrt. Sie können jedoch früher gelöscht werden, wenn eine Datei 100 Versionen hat, die nicht als „Für immer behalten“ gekennzeichnet sind, und eine neue Version hochgeladen wird.

Weitere Informationen zum Festlegen von Blob-Revisionen als „Für immer behalten“ finden Sie unter Revisionen angeben, die vor dem automatischen Löschen geschützt werden sollen.

Überarbeitungsverlauf

Eine chronologische Aufzeichnung aller Überarbeitungen einer Datei. Bei einer Änderung an einer Datei in Google Docs, Google Tabellen oder Google Präsentationen wird eine neue Version erstellt. Jedes Mal, wenn sich der Inhalt ändert, erstellt Drive einen neuen Eintrag im Überarbeitungsverlauf für diese Datei. Diese Editor-Dateiversionen können jedoch zusammengeführt werden. Daher werden in der API-Antwort möglicherweise nicht alle Änderungen an einer Datei angezeigt.