Änderungen und Überarbeitungen

In Google Drive wird automatisch ein Verlauf der Änderungen geführt, mit dem Nutzer Änderungen an Dateien und Inhaltsrevisionen nachverfolgen können. 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 „Revisionen“ 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.
Änderung
Eine Änderung am Inhalt oder an den Metadaten einer Datei oder geteilten Ablage.
Änderungsprotokoll für Nutzer

Eine Aufzeichnung aller Änderungen, die ein Nutzer an allen bearbeitbaren Dateien in „My Drive“ (Meine Ablage) vorgenommen hat, z. B. an Google Docs-, Google Sheets- oder Google Präsentationen-Dateien. Für Mitglieder einer geteilten Ablage enthält das Änderungsprotokoll für Nutzer auch Einträge zur Mitgliedschaft in der geteilten Ablage, zu den Nutzerzugriffsebenen auf Elemente in dieser geteilten Ablage und zu Änderungen am Namen der geteilten Ablage.

Änderungsprotokoll für geteilte Ablagen

Eine Aufzeichnung aller Änderungen an einer geteilten Ablage, z. B. Hinzufügungen oder Entfernungen von Nutzern, und aller Ä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 für geteilte Ablagen angezeigt.

Änderungsprotokolleintrag

Eine Aufzeichnung einer Änderung am Inhalt oder an den Metadaten einer Datei oder geteilten Ablage. Ein Änderungsprotokolleintrag enthält den Nutzer, der die Änderung vorgenommen hat, den Zeitstempel und eine ID. Im Änderungsprotokoll kann jeweils nur ein Eintrag pro Datei oder geteilter Ablage vorhanden sein. Jedes Mal, wenn sich die Datei oder geteilte Ablage ändert, wird eine neue ID für diesen Eintrag erstellt und der vorherige Eintrag ersetzt.

Revision

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

Aktuelle Revision

Die aktuelle Version einer Datei. Auf die headRevisionId kann über die files Ressource 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-Revision die einzige Revision der Binärdatei ist, kann sie nicht gelöscht werden. Ein neuer Blob kann als neue Revision hochgeladen werden, die zur neuen aktuellen Revision dieser Datei wird.

Alle Blob-Dateirevisionen, die nicht als „Niemals löschen“ gekennzeichnet sind, können gelöscht werden. Löschbare Revisionen werden in der Regel 30 Tage lang aufbewahrt, können aber früher gelöscht werden, wenn eine Datei 100 Revisionen enthält, die nicht als „Niemals löschen“ gekennzeichnet sind, und eine neue Revision hochgeladen wird.

Weitere Informationen zum Festlegen von Blob-Revisionen als "Niemals löschen" finden Sie unter Revisionen angeben, die nicht automatisch gelöscht werden sollen.

Überarbeitungsverlauf

Eine Aufzeichnung aller Revisionen einer Datei in chronologischer Reihenfolge. Eine Änderung an einer Google Docs-, Google Sheets- oder Google Präsentationen-Datei führt zu einer neuen Revision. Jedes Mal, wenn sich der Inhalt ändert, erstellt Drive einen neuen Eintrag im Überarbeitungsverlauf für diese Datei. Diese Revisionen von Editordateien können jedoch zusammengeführt werden, sodass in der API-Antwort möglicherweise nicht alle Änderungen an einer Datei angezeigt werden.