In Google Drive wird ein automatischer Änderungsverlauf gespeichert, Nutzer verfolgen Dateiänderungen und Inhaltsüberarbeitungen. Im Überarbeitungsverlauf können Nutzer sehen, welche Änderungen vorgenommen wurden, und eine bestimmte Version einer Datei wiederherstellen mit bestimmten Änderungen.
Die folgenden Begriffe sind relevant für die Ressourcen für Änderungen und Überarbeitungen der Google Drive-API:
- Access Control List (ACL)
- Die Liste aller Berechtigungsressourcen, die mit einer Datei, einem Ordner oder geteilte Ablage.
- Ändern
- Eine Änderung am Inhalt oder den Metadaten einer Datei oder einer freigegebenen Datei Drive.
- Änderungsprotokoll des Nutzers
- Ein Datensatz mit allen Änderungen, die ein Nutzer an jeder bearbeitbaren Datei in seinem eigenen Google Drive, z. B. Google Docs, Google Tabellen oder Google Präsentationen Für Mitglieder eines freigegebenen Drive enthält das Änderungsprotokoll auch Einträge zur geteilten Ablage Mitgliedschaft, Nutzerzugriffsebenen für Elemente in dieser geteilten Ablage und freigegebene Drive-Namen ändern.
- Änderungsprotokoll für geteilte Ablagen
- Ein Eintrag aller Änderungen an einer geteilten Ablage, z. B. neu hinzugefügte oder entfernte Nutzer und alle Änderungen an Elementen in dieser geteilten Ablage. Änderung an einem Element innerhalb einer geteilten Ablage wird sowohl im Änderungsprotokoll des Nutzers als auch im geteilten Ablage angezeigt Änderungsprotokoll.
- Logeintrag ändern
- Ein Datensatz zu einer Änderung des Inhalts oder der Metadaten einer Datei oder geteilte Ablage. Ein Änderungsprotokolleintrag gibt den Nutzer an, der die Änderung vorgenommen hat, die Zeitstempel und eine ID. Jede Datei oder geteilte Ablage kann nur einen Eintrag enthalten im Änderungsprotokoll speichern. Jedes Mal, wenn sich die Datei oder geteilte Ablage ändert, wird für diesen Eintrag eine neue ID erstellt und ersetzt den vorherigen Eintrag.
- Revision
- Eine Version der Datei, die eine Änderung des Dateiinhalts darstellt (keine Metadaten). Auf jede Überarbeitung kann über die Überarbeitungsressource in der Drive API.
- Hauptüberarbeitung
- Die aktuelle Version einer Datei
- Blob-Überarbeitung
Eine Version einer nicht änderbaren Binärdatei, z. B. eines Bildes, Videos oder einer PDF. Wenn die Blob-Revision die einzige Version der Binärdatei ist, kann sie nicht gelöscht. Ein neues Blob kann als neue Überarbeitung hochgeladen werden, die dann zum neuen Head-Revision dieser Datei.
Blob-Überarbeitungen können auf "Niemals löschen" festgelegt werden Das bedeutet, dass die Überarbeitung automatisch dauerhaft gelöscht. Bis zu 200 Überarbeitungen können auf "Niemals löschen" festgelegt werden. Die head-Revision wird nie automatisch gelöscht.
Jede Überarbeitung, mit Ausnahme der Head-Revision, die nicht als Dauerhaft“ gelöscht werden kann. Dauerhaft löschbare Überarbeitungen werden in der Regel 30 Minuten lang aufbewahrt. Tage, kann aber auch früher dauerhaft gelöscht werden, wenn eine Datei 100 Überarbeitungen enthält, die nicht mit der Kennzeichnung „Für immer behalten“ und eine neue Version wird hochgeladen.
Das Feld
keepForever
vonRevisions
Ressource verwendet, um eine Überarbeitung auf "Für immer behalten" festzulegen. Außerdem können Sierevisions.delete
aufrufen, um Folgendes zu löschen: auch wenn sie mit "Niemals löschen" markiert ist.- Überarbeitungsverlauf
Datensatz aller Überarbeitungen einer Datei in chronologischer Reihenfolge. Eine Änderung an einem Google Docs-, Google Tabellen- und Google Präsentationen-Dateien werden überarbeitet. Jedes Mal, wenn der Inhalt wird in Google Drive ein neuer Überarbeitungsverlaufseintrag für diese Datei erstellt. Sie können jedoch diese Editor-Dateiüberarbeitungen zusammengeführt werden, sodass die API-Antwort werden möglicherweise nicht alle Änderungen an einer Datei angezeigt.
In diesem Video erfahren Sie, wie Sie Überarbeitungen mit Google Drive verwalten API:
Nächste Schritte
- Informationen dazu, wo die zu verfolgende Änderung aufgezeichnet wird, finden Sie unter Legen Sie fest, welches Änderungsprotokoll verfolgt werden soll.
- Informationen zum Einrichten des Änderungs-Trackings für Nutzer und geteilte Ablagen finden Sie unter Änderungen für Nutzer und geteilte Ablagen im Blick behalten
- Informationen zum Veröffentlichen, Herunterladen oder Abfragen von Überarbeitungen finden Sie unter Laden Sie Dateiüberarbeitungen herunter und veröffentlichen Sie sie.
- Informationen zum Einrichten von Änderungsbenachrichtigungen findest du unter Push-Benachrichtigungen