Interfejs API Dysku Google 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 żąda danych o aktywności użytkownika za pomocą metody activity.query. Możesz poprosić o aktywność dotyczącą określonego elementu na Dysku lub wszystkich elementów w folderze Dysku. W przypadku danego żądania możesz wybrać dla niego ograniczenie z uwzględnieniem ograniczeń, takich jak zakres czasowy lub typ działania, oraz wybrać opcję skonsolidowania aktywności. Więcej informacji znajdziesz w artykule Wysyłanie żądań w interfejsie Drive Activity API.
Odpowiedź
Odpowiedź na żądanie to lista działań pasujących do podanych parametrów, gdzie zasób DriveActivity reprezentuje każdą aktywność:
Zasób DriveActivity to zbiór obiektów Action, z których każdy jest niezależny jako 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ń, ujednolicone działanie typu Timestamp lub TimeRange oraz najważniejsze lub reprezentatywne dane ActionDetail.
Więcej informacji znajdziesz w modelu danych interfejsu Drive Activity API.
Widoczność historii aktywności
Gdy używasz tego interfejsu API, niektóre działania na Dysku mogą nie być rejestrowane. To, czy interfejs Drive Activity API zgłasza daną zmianę w zależności od tego, czy ta zmiana, czy też informacje o niej, jest widoczna dla uwierzytelnionego użytkownika w aplikacji.
Widoczność zależy od uprawnień ustawionych dla obiektu. Gdy pliki i foldery są udostępniane na Dysku, dzieje się tak w kilku sytuacjach:
- Jeśli autor udostępni dokument, historia jego aktywności będzie widoczna nie tylko dla twórcy, ale też dla uwierzytelnionych użytkowników, którym został 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, gdy miał dostęp, i że uprawnienia są ograniczone.
- Jeśli dokument nigdy nie został udostępniony użytkownikowi, nie może zobaczyć historii aktywności.
Pierwsze kroki
Aby w pełni wykorzystać interfejs Drive Activity API, najpierw zintegruj aplikację z interfejsem Dysku Google API. Aby zacząć korzystać z interfejsu Drive Activity API, dowiedz się, jak utworzyć projekt i autoryzować żądania. Możesz też zapoznać się z materiałami dostępnymi w przewodniku po interfejsie API.