W przypadku aplikacji Dysku Google, które muszą śledzić zmiany w plikach, kolekcja changes
umożliwia skuteczne wykrywanie wszystkich zmian w plikach, w tym tych udostępnionych użytkownikowi. Jeśli plik uległ zmianie, kolekcja ta podaje aktualny stan każdego pliku.
Pobierz token strony startowej
Aby poprosić o token strony na potrzeby bieżącego stanu konta, skorzystaj z metody changes.getStartPageToken
.
Zapisz ten token i używaj go we wstępnym wywołaniu do changes.list
.
Aby pobrać token bieżącej strony:
Java
Python
PHP
.NET
Node.js
Pobierz zmiany
Aby pobrać listę zmian do obecnie zalogowanego użytkownika, wyślij żądanie GET
do kolekcji changes
zgodnie z opisem w changes.list
.
Wpisy w kolekcji changes
są podane w kolejności chronologicznej (najstarsze zmiany pojawiają się jako pierwsze). Parametry zapytania includeRemoved
i restrictToMyDrive
określają, czy odpowiedź powinna zawierać elementy usunięte czy udostępnione.
Java
Python
PHP
.NET
Node.js
Kolekcja changes
w odpowiedzi może zawierać element nextPageToken
. Jeśli nextPageToken
znajduje się na liście, może służyć do zebrania następnej strony ze zmianami. Jeśli nie ma go na liście, aplikacja kliencka powinna przechowywać w odpowiedzi newStartPageToken
do wykorzystania w przyszłości. Zapisany token strony sprawia, że aplikacja kliencka jest gotowa do ponownego wysyłania zapytań dotyczących przyszłych zmian.
Odbieranie powiadomień
Aby zasubskrybować aktualizacje w historii zmian, użyj metody changes.watch
. Powiadomienia nie zawierają
szczegółów o zmianach. Zamiast tego wskazują, że są dostępne nowe zmiany. Aby pobrać rzeczywiste zmiany, przeprowadź ankietę w pliku danych zmian zgodnie z opisem w sekcji Pobieranie zmian.
Więcej informacji znajdziesz w artykule Powiadomienia o zmianach zasobów.