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ą konkretnego elementu na Dysku lub wszystkich elementów znajdujących się w folderze na Dysku. W przypadku danego żądania możesz ograniczyć odpowiedź za pomocą ograniczeń, takich jak zakres czasu lub typ działania, a także możesz zdecydować, czy aktywność ma być skonsolidowana w odpowiedzi. 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 każdy element DriveActivity
reprezentuje jedno działanie:
Zasób DriveActivity
to zbiór obiektów Action
, z których każdy jest samodzielny, podobnie jak zdarzenie. Action
zawiera ActionDetail
(np. Create
lub Edit
), Actor
(np. User
lub Administrator
), Target
(np. DriveItem
lub Drive
) oraz Timestamp
lub TimeRange
.
DriveActivity
zawiera też informacje podsumowujące, takie jak wszystkie Actor
i Target
ze wszystkich działań, ujednolicony Timestamp
lub TimeRange
oraz 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 niektóre działania na Dysku mogą nie być raportowane. To, czy interfejs Drive Activity API zgłosi daną zmianę w obiekcie, 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. Pliki i foldery na Dysku są udostępniane w kilku scenariuszach:
- Jeśli autor udostępni dokument, historia aktywności związana z tym dokumentem będzie widoczna nie tylko dla twórcy, ale także dla uwierzytelnionych użytkowników, którym został on udostępniony.
- Jeśli dokument został udostępniony użytkownikowi, a następnie ustawiono go jako prywatny, uwierzytelniony użytkownik może zobaczyć całą historię aktywności z okresu, w którym miał dostęp do dokumentu, oraz informację, że uprawnienia są teraz ograniczone.
- Jeśli dokument nigdy nie został udostępniony użytkownikowi, nie może on zobaczyć żadnej historii aktywności.
Rozpocznij
Aby w pełni wykorzystać możliwości interfejsu Drive Activity API, najpierw zintegruj aplikację z interfejsem 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 przewodnika po interfejsie API i dowiedzieć się więcej o aktywnościach.