Interfejs Google Drive Activity API składa się z zasobu DriveActivity, który reprezentuje zmiany w obiektach na Dysku Google użytkownika, oraz z metody activity.query, która umożliwia pobieranie informacji o tych zmianach.
Prośba
Aplikacja prosi o dane o aktywności użytkownika, korzystając z metody activity.query. Możesz poprosić o działanie dotyczące określonego elementu na Dysku lub wszystkiego, co znajduje się w folderze na Dysku. W przypadku danego żądania możesz ograniczyć odpowiedź według ograniczeń, takich jak zakres czasowy lub typ działania, oraz skonsolidować aktywność w odpowiedzi. Więcej informacji znajdziesz w artykule Przesył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 autonomiczny jak zdarzenie. Element Action obejmuje ActionDetail (np. Create lub Edit), Actor (np. User lub Administrator), Target (np. DriveItem lub Drive) oraz Timestamp lub TimeRange.
Zasób DriveActivity zawiera też podsumowanie informacji, np. co Actor i Target ze wszystkich działań, ujednolicony Timestamp lub TimeRange, a także najważniejsze lub reprezentatywne ActionDetail z Action.
Więcej informacji znajdziesz w artykule Model danych interfejsu Drive Activity API.
Widoczność historii aktywności
Podczas korzystania z tego interfejsu API część aktywności na Dysku może nie być raportowana. To, czy interfejs Drive Activity API zgłasza daną zmianę obiektu, zależy od tego, czy ta zmiana lub informacje o niej są widoczne dla uwierzytelnionego użytkownika aplikacji.
Widoczność zależy od uprawnień ustawionych dla obiektu. Udostępnianie plików i folderów na Dysku jest możliwe w kilku sytuacjach:
- Jeśli autor udostępni dokument, historia aktywności związanej z dokumentem będzie widoczna nie tylko dla twórcy, 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 oznaczony jako prywatny, uwierzytelniony użytkownik może zobaczyć całą historię aktywności, gdy miał dostęp, i że jego uprawnienia są teraz ograniczone.
- Jeśli dokument nie został nigdy udostępniony użytkownikowi, nie zobaczy on żadnej 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 przejść do szczegółów aktywności i poczytać o działaniach w dokumentacji interfejsu API.