Für Google Drive-Apps, die Änderungen an Elementen in Drive im Blick behalten müssen, bietet die Sammlung „Änderungen“ eine effiziente Möglichkeit, Änderungen zu erkennen. Die Sammlung gibt den aktuellen Status jedes Artikels an, aber nur dann, wenn sich der Artikel seit einem bestimmten Zeitpunkt geändert hat.
In Google Drive wird für jeden Nutzer und jede geteilte Ablage ein Änderungsprotokoll geführt. Jedes hat einen eigenen Änderungsverlauf für Elemente, die für sie von Interesse sind.
Wenn Sie Änderungen an allen für einen Nutzer sichtbaren Elementen nachverfolgen möchten, müssen sowohl das Änderungsprotokoll des Nutzers als auch die Änderungsprotokolle für alle freigegebenen Ablagen, in denen der Nutzer Mitglied ist, wiedergegeben werden.
Änderungseinträge aktivieren
Ein Änderungseintrag stellt den Zustand der Datei oder geteilten Ablage zu einem bestimmten Zeitpunkt dar. Eine Änderung enthält kein Delta zwischen den Versionen. Anwendungen, die wissen müssen, welche Eigenschaften sich geändert haben, sollten den zuvor bekannten Status des Artikels 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.
Grabsteine
Änderungseinträge für Elemente, die für einen Nutzer nicht mehr verfügbar sind, sind im Änderungseintrag als deleted gekennzeichnet. Im Änderungseintrag 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 berücksichtigt. Wenn eine Datei zu einer geteilten Ablage gehört, wird ihr Status nicht korrekt aktualisiert, wenn nur das Änderungsprotokoll des Nutzers wiedergegeben wird, auch wenn die Datei in der Vergangenheit im Änderungsprotokoll des Nutzers aufgeführt war. Stattdessen müssen Sie das Änderungsprotokoll der geteilten Ablage wiedergeben, um alle Änderungen zu erfassen.
Was ist im Änderungsprotokoll eines Nutzers enthalten?
Das Änderungsprotokoll eines Nutzers enthält Änderungen an geteilten Ablagen, in denen er Mitglied ist, sowie Änderungen an Dateien im Corpus des Nutzers. Weitere Informationen zu Corpora finden Sie unter Änderungen und Überarbeitungen – Übersicht.
Diese Änderungen an geteilten Ablagen werden im Änderungsprotokoll des Nutzers angezeigt:
- Der Nutzer wird Mitglied einer geteilten Ablage.
- Der Nutzer ist kein Mitglied mehr einer geteilten Ablage.
- 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 freigegebene Google Drive-Ablage hat sich 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. Das bedeutet Zugriff auf alle Elemente in der geteilten Ablage. Der Nutzer erhält keine Benachrichtigungen über Änderungen an Elementen in der geteilten Ablage, wenn er Mitglied wird.
Mitglieder einer geteilten Ablage können Änderungsereignisse für Elemente in einer geteilten Ablage sehen, je nachdem, wie sie diese verwenden. Anwendungen sollten jedoch nicht auf diese Ereignisse zurückgreifen, wenn der Nutzer Mitglied der geteilten Ablage ist. Verwenden Sie stattdessen das Änderungsprotokoll der geteilten Ablage, um Änderungen im Blick zu behalten.
Wenn einem Nichtmitglied Dateizugriff auf einzelne Elemente in einer geteilten Ablage gewährt wird, werden Änderungen an diesen Elementen im Änderungsprotokoll des Nutzers erfasst. Das gilt auch für nicht freigegebene Drive-Elemente, die 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 den Änderungsprotokoll dieser geteilten Ablage zugreifen. Dieses enthält Folgendes:
- 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 vornehmen
Berechtigungen und Funktionen synchronisieren
Berechtigungsänderungen an einer geteilten Ablage oder an Elementen in einer geteilten Ablage wirken sich nur auf das Element selbst aus. Alle direkten oder indirekten untergeordneten Elemente dieses Elements übernehmen diese Änderung. Im Änderungsprotokoll gibt es jedoch keinen separaten Eintrag für jedes dieser Elemente. Clients müssen entweder die neuen Funktionen weitergeben oder jeden Artikel neu abrufen, wenn sich ein übergeordnetes Element geändert hat, um die Änderungen vollständig zu rekonstruieren.