Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 mit einer Datei, einem Ordner oder einer geteilten Ablage verknüpft 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 „Mein Drive“ vorgenommen hat, z. B. an einer Google Docs-, Google Sheets- oder 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
Ein Protokoll 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 Änderungsprotokolleintrag enthält den Nutzer, der die Änderung vorgenommen hat, den Zeitstempel und eine ID. Pro Datei oder geteilter Ablage kann im Änderungslog immer nur ein Eintrag vorhanden sein. Jedes Mal, wenn sich die Datei oder geteilte Ablage ändert, wird eine neue ID für den Eintrag erstellt und der vorherige Eintrag ersetzt.
Revision
Eine Version der Datei, die eine Änderung am Inhalt der Datei (nicht an den Metadaten) darstellt. Auf jede Revision 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 Version hochgeladen werden, die zur neuen Head-Version dieser Datei wird.
Alle Blob-Dateiüberarbeitungen, die nicht die Head-Überarbeitung sind und nicht als „Niemals löschen“ gekennzeichnet sind, können 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.
Eine chronologische Aufzeichnung aller Überarbeitungen einer Datei. Bei einer Änderung an einer Datei in Google Docs, Google Sheets oder Google Präsentationen wird eine neue Version erstellt. Jedes Mal, wenn sich der Inhalt ändert, wird in Drive ein neuer Eintrag im Versionsverlauf für die Datei erstellt. Diese Editor-Dateirevisionen können jedoch zusammengeführt werden, sodass in der API-Antwort möglicherweise nicht alle Änderungen an einer Datei angezeigt werden.
Informationen zum Herunterladen einer Blob-Dateiinhaltsrevision oder zum Exportieren einer Google Workspace-Dokumentinhaltsrevision finden Sie unter Dateien herunterladen und exportieren.
[null,null,["Zuletzt aktualisiert: 2025-08-21 (UTC)."],[],[],null,["# Changes and revisions overview\n\nGoogle Drive maintains an automatic history of modifications, which can help\nusers track file changes and content revisions. In the revision history, users\ncan see what edits have been made and can revert to a specific version of a file\nwith specific edits.\n\nThe following terms are relevant to the changes and revisions resources of the\nGoogle Drive API:\n\n*Access Control List (ACL)*\n: The list of all permission resources associated with a file, folder, or shared\n drive.\n\n*Change*\n: An alteration made to a file's content or metadata of a file or shared drive.\n\n*User change log*\n\n: A record of all changes that a user made to every editable file in their My\n Drive, such as a Google Docs, Sheets, or a\n Slides. For members of a shared drive, the user change log\n also includes entries about shared drive membership, user access levels to\n items in that shared drive, and shared drive name changes.\n\n | **Note:** Even if several users can access the same file, not all changes to that file are reflected in every users' change log. For example, when a user opens the file for the first time, or marks the file as Starred, those changes only appear in that users' change log. As another example, when a file's ACL is changed, it's only reflected in the change log of the following users: The file's owner, any service accounts on the ACL, and any users directly impacted by the ACL change.\n\n*Shared drive change log*\n\n: A record of all changes to a shared drive, such as additions or removals of\n users, and all changes to items on that shared drive. A change to an item\n within a shared drive appears in both the *user change log* and shared drive\n change log.\n\n*Change log entry*\n\n: A record of a change made to a file's content or metadata of a file or shared\n drive. A change log entry indicates the user who made the change, the\n timestamp, and an ID. There can only be one entry per file or shared drive\n in the change log at a time. Each time that file or shared drive changes, a\n new ID is created for that entry, and it replaces the previous entry.\n\n*Revision*\n\n: A version of the file representing a change to the file's contents (not\n metadata). Each revision can be accessed using the [`revisions`](/workspace/drive/api/reference/rest/v3/revisions) resource within the Drive API.\n\n*Head revision*\n\n: The most current version of a file. The `headRevisionId` can be accessed using\n the [`files`](/workspace/drive/api/reference/rest/v3/files) resource within the\n Drive API. The `headRevisionId` is only available for blob files\n in Drive.\n\n*Blob revision*\n\n: A version of an unmodifiable binary file, such as an image, video, or PDF. If\n the blob revision is the only revision of the binary file, it cannot be\n deleted. A new blob can be uploaded as a new *revision* , which becomes the\n new *head revision* of that file.\n\n Any blob file revision, other than the head revision, that's not designated\n as \"Keep Forever\" is purgeable. Purgeable revisions are typically preserved\n for 30 days, but can be purged earlier if a file has 100 revisions that\n aren't designated as \"Keep Forever\" and a new revision is uploaded.\n\n For more information on setting blob revisions as \"Keep Forever\", see\n [Specify revisions to save from auto\n delete](/workspace/drive/api/guides/manage-revisions#specify-revisions).\n\n*Revision history*\n\n: A record of all revisions of a file in chronological order. A change to a\n Docs, Sheets, or Slides file\n gets a new revision. Each time the content changes, Drive\n creates a new revision history entry for that file. However, these editor\n file revisions may be merged together, so the API response might not show\n all changes to a file.\n\nRelated topics\n--------------\n\n- To identify where the change you want to track is recorded, see [Identify\n which change log to track](/workspace/drive/api/guides/about-changelogs).\n- To set up change tracking for users and shared drives, see [Track changes\n for users and shared drives](/workspace/drive/api/guides/about-changes).\n- To download a blob file content revision or to export a Google Workspace document content revision, see [Download and export\n files](/workspace/drive/api/guides/manage-downloads).\n- To publish a revision, see [Manage file\n revisions](/workspace/drive/api/guides/manage-revisions).\n- To set up change notifications, see [Notifications for resource changes](/workspace/drive/api/guides/push)."]]
