Änderungen für Nutzer und geteilte Ablagen im Blick behalten

Für Google Drive-Apps, die Änderungen an Elementen in Drive nachverfolgen müssen, bietet die Sammlung von Änderungen eine effiziente Möglichkeit, Änderungen zu erkennen. Die Sammlung liefert den aktuellen Status jedes Elements, und zwar nur dann, wenn sich das Element seit einem bestimmten Zeitpunkt geändert hat.

In Google Drive wird für jeden Nutzer und jede geteilte Ablage ein Änderungsprotokoll erstellt. Jeder hat seinen eigenen Datensatz mit Änderungen an Elementen, die für ihn von Interesse sind.

Wenn Sie Änderungen an allen für einen Nutzer sichtbaren Elementen verfolgen möchten, müssen sowohl das Nutzer-Änderungsprotokoll als auch die Änderungsprotokolle für alle geteilten Ablagen, in denen der Nutzer Mitglied ist, noch einmal abgespielt werden.

Änderungseinträge aktivieren

Ein Änderungseintrag stellt den Status der Datei oder geteilten Ablage zu einem bestimmten Zeitpunkt dar. Eine Änderung führt nicht zu einem Unterschied zwischen den Überarbeitungen. Anwendungen, die wissen müssen, welche Attribute sich geändert haben, sollten den zuvor bekannten Status des Elements beibehalten und vergleichen.

Da Änderungen den aktuellen Status eines Elements darstellen, können einzelne Änderungseinträge für das entsprechende Element ungültig gemacht und durch einen neueren Änderungseintrag ersetzt werden.

Grabsteine

Änderungseinträge für Elemente, die für einen Nutzer nicht mehr verfügbar sind, sind im Änderungseintrag mit deleted gekennzeichnet. Im Änderungseintrag steht nur die ID des Elements zur Verfügung.

Geteilte Ablagen beobachten

Für jede geteilte Ablage gibt es ein eigenes Änderungsprotokoll. Auch wenn ein Nutzer Mitglied einer geteilten Ablage ist, werden bestimmte Änderungen nur im Änderungsprotokoll der geteilten Ablage und nie im Änderungsprotokoll des Nutzers widergespiegelt. Wenn eine Datei zu einer geteilten Ablage gehört, wird der Status der Datei nicht korrekt aktualisiert, auch wenn die Datei zu einem früheren Zeitpunkt noch im Änderungsprotokoll des Nutzers enthalten war. Stattdessen müssen Sie das Änderungsprotokoll der geteilten Ablage noch einmal wiedergeben, um alle Änderungen zu erfassen.

Inhalt des Änderungsprotokolls eines Nutzers

Das Änderungsprotokoll eines Nutzers enthält Änderungen an geteilten Ablagen, in denen er Mitglied ist, sowie Änderungen an Dateien im Korpus des Nutzers. Weitere Informationen zu Korpora finden Sie unter Übersicht über Änderungen und Überarbeitungen.

Die folgenden Änderungen an geteilten Ablagen werden im Änderungsprotokoll des Nutzers aufgeführt:

  • Der Nutzer wird Mitglied einer geteilten Ablage.
  • Der Nutzer ist kein Mitglied einer geteilten Ablage mehr.
  • Es gibt eine direkt relevante Änderung an einer geteilten Ablage, in der der Nutzer Mitglied ist, z. B.:
    • Die Zugriffsebene des Nutzers für diese geteilte Ablage wurde geändert.
    • Die geteilte Ablage wird umbenannt.

Wenn ein Nutzer Mitglied einer geteilten Ablage wird, wird im Änderungsprotokoll des Nutzers ein einzelnes Änderungsereignis für die geteilte Ablage angezeigt. Dies impliziert Zugriff auf alle Elemente in der geteilten Ablage. Wenn der Nutzer Mitglied wird, erhält er keine Änderungen an Elementen in der geteilten Ablage.

Mitglieder einer geteilten Ablage können Änderungsereignisse für Elemente in einer geteilten Ablage auf Grundlage ihrer Nutzung sehen. Anwendungen sollten jedoch nicht auf diese Ereignisse angewiesen sein, wenn der Nutzer Mitglied der geteilten Ablage ist. Verwenden Sie stattdessen das Änderungsprotokoll der geteilten Ablage, um die Änderungen zu verfolgen.

Wenn einem Nichtmitglied Dateizugriff auf einzelne Elemente in einer geteilten Ablage gewährt wird, werden Änderungen an diesen Elementen im Änderungsprotokoll des Nutzers erfasst. Dies entspricht den nicht freigegebenen Drive-Elementen, die direkt für Nutzer freigegeben sind.

Änderungen im Änderungsprotokoll einer geteilten Ablage

Wenn ein Nutzer Mitglied einer geteilten Ablage ist, kann er auf das Änderungsprotokoll dieser geteilten Ablage zugreifen, das Folgendes enthält:

  • Alle Änderungen an der geteilten Ablage, z. B. das Hinzufügen oder Entfernen eines Mitglieds
  • Direkte Änderungen an den Elementen in der geteilten Ablage.

Berechtigungen und Funktionen synchronisieren

Änderungen an Berechtigungen für die geteilte Ablage oder für Elemente in einer geteilten Ablage werden nur für das Element selbst übernommen. Alle direkten oder indirekten untergeordneten Elemente dieses Elements übernehmen diese Änderung. Es gibt jedoch keinen separaten Eintrag im Änderungsprotokoll für jedes dieser Elemente. Clients müssen die neuen Funktionen entweder weitergeben oder jedes Element noch einmal abrufen, wenn sich ein übergeordnetes Element geändert hat, um die Änderungen vollständig zu rekonstruieren.