W przypadku aplikacji Dysku Google, które muszą śledzić zmiany elementów na Dysku, kolekcja Changes zapewnia skuteczny sposób wykrywania zmian. Kolekcja działa w ten sposób, że podaje bieżący stan każdego elementu, ale tylko wtedy, gdy element uległ zmianie od określonego momentu.
Dysk Google prowadzi dziennik zmian dla każdego użytkownika i dysku współdzielonego. Każdy z nich ma własną listę zmian w produktach, które go interesują.
Aby śledzić zmiany dotyczące wszystkich elementów widocznych dla użytkownika, należy odtworzyć dziennik zmian użytkownika i dzienniki zmian wszystkich dysków współdzielonych, do których należy użytkownik.
Włączanie wpisów zmian
Wpis zmiany reprezentuje stan pliku lub dysku współdzielonego w danym momencie. Zmiana nie zawiera różnicy między wersjami. Aplikacje, które muszą wiedzieć, które właściwości uległy zmianie, powinny zachować poprzedni stan elementu i go porównać.
Ponieważ zmiany odzwierciedlają bieżący stan produktu, poszczególne wpisy zmian mogą zostać unieważnione i zastąpione nowszym wpisem zmian dla odpowiedniego produktu.
Elementy tombstone
Wpisy zmian dotyczące elementów, które nie są już dostępne dla użytkownika, są oznaczone symbolem deleted
. W pozycji zmiany dostępny jest tylko identyfikator produktu.
Śledzenie dysków współdzielonych
Każdy dysk współdzielony ma własny dziennik zmian. Nawet jeśli użytkownik jest członkiem dysku współdzielonego, niektóre zmiany są odzwierciedlane tylko w dzienniku zmian dysku współdzielonego, a nigdy w dzienniku zmian użytkownika. Jeśli plik należy do dysku współdzielonego, nawet jeśli w przeszłości pojawił się w dzienniku zmian użytkownika, odtworzenie samego dziennika zmian użytkownika nie spowoduje prawidłowej aktualizacji stanu pliku. Zamiast tego musisz odtworzyć dziennik zmian dysku współdzielonego, aby zarejestrować wszystkie zmiany.
Co zawiera dziennik zmian użytkownika
Dziennik zmian użytkownika obejmuje zmiany na dyskach współdzielonych, których jest on użytkownikiem, a także zmiany w plikach w jego korpusie. Więcej informacji o korpusach znajdziesz w artykule Omówienie zmian i poprawek.
Zmiany na dysku współdzielonym pojawiają się w dzienniku zmian użytkownika:
- Użytkownik staje się użytkownikiem dysku współdzielonego.
- Użytkownik nie jest już użytkownikiem dysku współdzielonego.
- Na dysku współdzielonym, którego użytkownik jest członkiem, nastąpiła bezpośrednio związana zmiana, np.:
- Poziom dostępu użytkownika do tego dysku współdzielonego został zmieniony.
- Nazwa dysku współdzielonego zostanie zmieniona.
Gdy użytkownik stanie się członkiem dysku współdzielonego, w dzienniku zmian użytkownika pojawi się jedno zdarzenie zmiany dotyczące tego dysku. Oznacza to dostęp do wszystkich elementów na dysku współdzielonym. Użytkownik nie otrzymuje zmian dotyczących elementów znajdujących się na dysku współdzielonym, gdy staje się jego użytkownikiem.
Użytkownicy dysku współdzielonego mogą widzieć zdarzenia związane ze zmianami elementów na dysku współdzielonym na podstawie ich użytkowania. Aplikacje nie powinny jednak polegać na tych zdarzeniach, gdy użytkownik jest użytkownikiem dysku współdzielonego. Zamiast tego użyj dziennika zmian dysku współdzielonego, aby śledzić zmiany.
Jeśli użytkownik, który nie jest członkiem dysku współdzielonego, otrzyma dostęp do poszczególnych elementów na tym dysku, zmiany w tych elementach będą śledzone w dzienniku zmian użytkownika. Dotyczy to elementów na dysku, które nie są dyskami współdzielonymi i zostały udostępnione bezpośrednio użytkownikom.
Zmiany, które pojawiają się w dzienniku zmian dysku współdzielonego
Jeśli użytkownik jest członkiem dysku współdzielonego, może uzyskać dostęp do dziennika zmian tego dysku, który zawiera:
- wszelkie zmiany na samym dysku współdzielonym, takie jak dodanie lub usunięcie użytkownika;
- bezpośrednio zmieniać elementy znajdujące się na dysku współdzielonym;
Synchronizowanie uprawnień i możliwości
Zmiany uprawnień na dysku współdzielonym lub dotyczące elementów na dysku współdzielonym są odzwierciedlane tylko w przypadku samego elementu. Wszystkie bezpośrednie i pośrednie elementy podrzędne tego elementu odziedziczą tę zmianę, ale w dzienniku zmian nie będzie osobnego wpisu dla każdego z nich. Aby w pełni odtworzyć zmiany, klienci muszą rozpowszechnić nowe możliwości lub ponownie pobrać każdy element, jeśli element nadrzędny uległ zmianie.