Ten dokument zawiera omówienie interfejsu Google Drive Activity API.
Interfejs Drive Activity API umożliwia wysyłanie zapytań o ostatnie zdarzenia. Możesz pobrać szczegółową historię wszystkich aktywności, w tym szczegółowe informacje o każdym zdarzeniu. Jest to przydatne w przypadku zadań takich jak audyty, ponieważ możesz pobierać dokładne informacje o aktywności, w tym informacje o parametrach ActionDetail, Actor i Target.
Interfejs Drive Activity API składa się z zasobu
DriveActivity, który reprezentuje
zmiany wprowadzone w obiektach na Dysku Google użytkownika, oraz metody
activity.query, która umożliwia pobieranie
informacji o tych zmianach.
Żądanie
Aplikacja wysyła żądanie danych o aktywności użytkownika za pomocą metody activity.query. Możesz poprosić o aktywność dotyczącą konkretnego elementu na Dysku lub wszystkich elementów znajdujących się w folderze na Dysku. W przypadku danego żądania możesz ograniczyć
odpowiedź za pomocą filtra, np. zakresu czasu
lub typu działania, a także skonsolidowaćaktywność w odpowiedzi. Więcej informacji znajdziesz w artykule Wysyłanie żądań w interfejsie Google Drive Activity API.
Odpowiedź
Odpowiedź zawiera listę aktywności pasujących do podanych parametrów, gdzie
każda DriveActivity aktywność jest reprezentowana przez zasób:
Zasób DriveActivity to zbiór
Action obiektów, z których każdy jest samodzielny
jak zdarzenie. Action zawiera ActionDetail (np. Create lub Edit), Actor (np. User lub Administrator), Target (np. DriveItem lub Drive) oraz
Timestamp
lub TimeRange.
Zasób DriveActivity zawiera też informacje podsumowujące, takie jak każdy
Actor i Target ze wszystkich działań, ujednolicony Timestamp lub TimeRange,
oraz najważniejszy lub reprezentatywny ActionDetail działania Action.
Więcej informacji znajdziesz w artykule Model danych interfejsu Drive Activity API.
Widoczność historii aktywności
Niektóre aktywności na Dysku mogą nie być raportowane, gdy używasz interfejsu Drive Activity API. To, czy interfejs API zgłosi daną zmianę obiektu, zależy od tego, czy zmiana lub informacje o niej są widoczne dla uwierzytelnionego użytkownika w Twojej aplikacji.
Widoczność zależy od uprawnień ustawionych dla obiektu. Istnieje kilka scenariuszy udostępniania plików i folderów na Dysku:
Jeśli autor udostępni dokument, historia aktywności związana z tym dokumentem będzie widoczna zarówno dla twórcy, jak i dla użytkowników, którym został on udostępniony.
Jeśli dokument został udostępniony użytkownikowi, a następnie ustawiono go jako prywatny, użytkownik może zobaczyć całą historię aktywności z okresu, w którym miał dostęp, ale nie po ograniczeniu uprawnień.
Jeśli dokument nigdy nie został udostępniony użytkownikowi, nie może on zobaczyć żadnej historii aktywności.
Powiązane artykuły
- Aby w pełni wykorzystać interfejs Drive Activity API, najpierw zintegruj swoją aplikację z interfejsem Google Drive API
- Więcej informacji o tworzeniu aplikacji za pomocą interfejsów Google Workspace API, w tym o tworzeniu projektu oraz obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Tworzenie aplikacji w Google Workspace.
- Więcej informacji o aktywnościach znajdziesz w dokumentacji API.