Für Google Drive-Apps, die Änderungen an Elementen in Drive nachverfolgen müssen, bietet die Changes-Sammlung eine effiziente Möglichkeit, Änderungen zu erkennen. Bei der Erfassung wird der aktuelle Status jedes Elements bereitgestellt, aber nur, 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 geführt. Jeder hat seine eigene Aufzeichnung von Änderungen an Elementen, die für ihn von Interesse sind.
Wenn Sie Änderungen für alle Elemente nachvollziehen möchten, die für einen Nutzer sichtbar sind, müssen sowohl das Nutzer-Änderungsprotokoll als auch die Änderungsprotokolle für alle geteilten Ablagen, in denen der Nutzer Mitglied ist, wiedergegeben werden.
Änderungseinträge aktivieren
Ein Änderungs-Eintrag stellt den Status der Datei oder geteilten Ablage zu einem bestimmten Zeitpunkt dar. Eine Änderung bietet kein Delta zwischen Ü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 Artikels darstellen, können einzelne Änderungseinträge ungültig gemacht und durch einen neueren Änderungseintrag für den entsprechenden Artikel ersetzt werden.
Tombstones
Änderungseinträge für Elemente, die für einen Nutzer nicht mehr verfügbar sind, sind im Änderungseintrag mit deleted gekennzeichnet. Im Änderungsdatensatz ist nur die ID des Artikels verfügbar.
Geteilte Ablagen im Blick behalten
Jede geteilte Ablage hat 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 angezeigt. Wenn eine Datei zu einer geteilten Ablage gehört, wird der Status der Datei nicht korrekt aktualisiert, wenn nur das Änderungsprotokoll des Nutzers wiedergegeben wird, auch wenn die Datei irgendwann in der Vergangenheit im Änderungsprotokoll des Nutzers angezeigt wurde. Stattdessen müssen Sie das Änderungsprotokoll der geteilten Ablage noch einmal durchlaufen, um alle Änderungen zu erfassen.
Inhalt des Änderungsprotokolls eines Nutzers
Das Änderungsprotokoll eines Nutzers enthält sowohl Änderungen an geteilten Ablagen, in denen er Mitglied ist, als auch Änderungen an Dateien im Korpus des Nutzers. Weitere Informationen zu Korpora finden Sie unter Änderungen und Überarbeitungen – Übersicht.
Diese Änderungen an der geteilten Ablage werden im Änderungsverlauf des Nutzers angezeigt:
- 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 Änderungslog des Nutzers ein einzelnes Änderungsereignis für die geteilte Ablage angezeigt. Das bedeutet, dass sie Zugriff auf alle Elemente in der geteilten Ablage haben. Der Nutzer erhält keine Änderungen für Elemente, die in der geteilten Ablage enthalten sind, wenn er Mitglied wird.
Mitglieder einer geteilten Ablage sehen möglicherweise Änderungsereignisse für Elemente in einer geteilten Ablage, die auf ihrer Nutzung basieren. Anwendungen sollten sich jedoch nicht auf diese Ereignisse verlassen, wenn der Nutzer Mitglied der geteilten Ablage ist. Verwenden Sie stattdessen das Änderungsprotokoll der geteilten Ablage, um Änderungen nachzuverfolgen.
Wenn einem Nichtmitglied der Dateizugriff auf einzelne Elemente in einer geteilten Ablage gewährt wird, werden Änderungen an diesen Elementen im Änderungsprotokoll des Nutzers erfasst. Das ist dasselbe wie bei Drive-Elementen, die nicht in einer geteilten Ablage gespeichert sind und direkt für Nutzer freigegeben werden.
Änderungen, die im Änderungsprotokoll einer geteilten Ablage angezeigt werden
Wenn ein Nutzer Mitglied einer geteilten Ablage ist, kann er auf das Änderungsprotokoll der geteilten Ablage zugreifen. Dieses enthält:
- Alle Änderungen an der geteilten Ablage selbst, z. B. das Hinzufügen oder Entfernen eines Mitglieds
- Direkte Änderungen an den Elementen in der geteilten Ablage
Berechtigungen und Funktionen synchronisieren
Berechtigungsänderungen für eine geteilte Ablage oder 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 Änderungslog für jedes dieser Elemente. Clients müssen entweder die neuen Funktionen weitergeben oder jedes Element neu abrufen, wenn sich ein übergeordnetes Element geändert hat, um die Änderungen vollständig zu rekonstruieren.