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.