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 prosi o dane o aktywności użytkownika za pomocą metody activity.query. Możesz poprosić o aktywność dotyczącą konkretnego elementu na Dysku lub wszystkiego, co znajduje się w folderze na Dysku. W przypadku danego zapytania możesz ograniczyć odpowiedź za pomocą ograniczeń, takich jak zakres czasowy lub typ działania. Możesz też wybrać, aby w odpowiedzi skonsolidować aktywność. Więcej informacji znajdziesz w artykule Przesyłanie żądań do interfejsu Drive Activity API.
Odpowiedź
Odpowiedź na żądanie to lista aktywności pasujących do podanych parametrów, w której zasób DriveActivity reprezentuje każdą aktywność:
Zasób DriveActivity to zbiór obiektów Action, z których każdy jest samowystarczalny jak zdarzenie. Element Action zawiera element ActionDetail (taki jak Create lub Edit), element Actor (taki jak User lub Administrator), element Target (taki jak DriveItem lub Drive) oraz element Timestamp lub TimeRange.
Zasób DriveActivity zawiera też informacje podsumowujące, takie jak wszystkie Actor i Target ze wszystkich działań, zjednoczony Timestamp lub TimeRange oraz najważniejsze lub najbardziej reprezentatywne ActionDetail z Action.
Więcej informacji znajdziesz w modelu danych interfejsu Drive Activity API.
Widoczność historii aktywności
Niektóre działania na Dysku mogą nie zostać zgłoszone, gdy używasz tego interfejsu API. To, czy interfejs Drive Activity API zgłasza 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. Udostępnianie plików i folderów na Dysku może odbywać się na kilka sposobów:
- Jeśli autor udostępni dokument, historia aktywności związana z tym dokumentem będzie widoczna nie tylko dla jego twórcy, ale też dla uwierzytelnionych użytkowników, którym został on udostępniony.
- Jeśli dokument został udostępniony użytkownikowi, a następnie ustawiony jako prywatny, uwierzytelniony użytkownik może zobaczyć całą historię aktywności z okresu, gdy miał dostęp do dokumentu, oraz informacje o tym, że uprawnienia zostały ograniczone.
- Jeśli dokument nie został nigdy udostępniony użytkownikowi, nie będzie on widzieć żadnej historii aktywności.
Rozpocznij
Aby w pełni wykorzystać możliwości interfejsu Drive Activity API, najpierw zintegruj swoją aplikację z interfejsem Drive API. Aby rozpocząć korzystanie z interfejsu Drive Activity API, dowiedz się, jak utworzyć projekt i autoryzować żądania. Możesz też przejść bezpośrednio do sekcji Przewodnik po interfejsie API, aby dowiedzieć się więcej o aktywnościach.