Interfejs Google 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ą określonego elementu na Dysku lub wszystkich elementów w folderze na Dysku. W przypadku danego żądania możesz ograniczyć odpowiedź według ograniczeń, takich jak zakres czasu lub typ działania, oraz skonsolidowanie aktywności w odpowiedzi. Więcej informacji znajdziesz w artykule Wysyłanie żądań w interfejsie Drive Activity API.
Odpowiedź
Odpowiedź na żądanie to lista aktywności pasujących do podanych parametrów, gdzie zasób DriveActivity reprezentuje poszczególne działania:
Zasób DriveActivity to zbiór obiektów Action, z których każdy jest samodzielnym jak zdarzenie. Action obejmuje obiekt 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, np. wszystkie Actor i Target ze wszystkich działań, ujednolicone Timestamp lub TimeRange, a także najważniejsze lub reprezentatywne informacje ActionDetail dotyczące elementu Action.
Więcej informacji znajdziesz w artykule o 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ć raportowane. To, czy interfejs Drive Activity API zgłasza daną zmianę w obiekcie, zależy od tego, czy zmiana lub informacje o niej są widoczne dla uwierzytelnionego użytkownika w aplikacji.
Widoczność zależy od uprawnień ustawionych dla obiektu. Udostępnianie plików i folderów na Dysku ma kilka scenariuszy:
- Jeśli autor udostępni dokument, jego historia aktywności będzie widoczna nie tylko dla niego, ale także dla uwierzytelnionych użytkowników, którym ten dokument 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, do której miał dostęp, a uprawnienia zostały teraz ograniczone.
- Jeśli dokument nigdy nie został udostępniony użytkownikowi, nie zobaczy on historii aktywności.
Rozpocznij
Aby w pełni wykorzystać możliwości interfejsu Drive Activity API, najpierw zintegruj swoją aplikację z Google Drive API. Aby zacząć korzystać z interfejsu Drive Activity API, dowiedz się, jak utworzyć projekt i autoryzować żądania. Możesz też od razu zagłębić się w działania i poczytać o działaniach w dokumentacji interfejsu API.