Interfejs Google Drive Activity API składa się z:
DriveActivity, które
wskazuje zmiany wprowadzone w obiektach na Dysku Google użytkownika,
activity.query, która umożliwia pobranie
o tych zmianach.
Żądanie
Aplikacja wysyła żądanie danych o aktywności użytkownika za pomocą
activity.query. Możesz poprosić o aktywność
w odniesieniu do konkretnego elementu na Dysku lub całej zawartości Dysku
folderu Dysku. W przypadku danego żądania możesz ograniczyć odpowiedzi,
ograniczeń, takich jak zakres czasu lub typ działania,
możemy skonsolidować aktywność w raporcie
. 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 odpowiada każdej aktywności:
Zasób DriveActivity to zbiór
Action obiektów, z których każdy jest
są niezależne jak wydarzenie. Action zawiera element
ActionDetail (np. Create
lub Edit), Actor (np. User
lub Administrator), Target (np.
jako DriveItem lub Drive) oraz
Timestamp
lub TimeRange.
Zasób DriveActivity zawiera też
podsumowujące, np.
Actor i
Target ze wszystkich działań, ujednolicony,
Timestamp
lub TimeRange i może być większość
ważny lub reprezentatywny
ActionDetail z
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. Określa, czy Interfejs Drive Activity API zgłasza daną zmianę w obiekcie lub informacje o niej są widoczne dla uwierzytelnionego użytkownika w aplikacji.
Widoczność zależy od uprawnień ustawionych dla obiektu. Jest ich kilka w sytuacjach, gdy pliki i foldery są udostępniane na Dysku:
- Jeśli autor udostępni dokument, historia aktywności związana z tym dokumentem jest widoczny nie tylko dla twórcy, ale także dla uwierzytelnionych użytkowników. osobom, którym został udostępniony.
- Jeśli dokument został udostępniony użytkownikowi, a następnie określony jako prywatny, użytkownik może wyświetlić całą historię aktywności, kiedy miał dostęp, a uprawnienia zostały ograniczony.
- Jeśli dokument nigdy nie został udostępniony użytkownikowi, nie będzie on widział aktywności historię.
Rozpocznij
Aby w pełni wykorzystać możliwości interfejsu Drive Activity API, zintegruj swoją aplikację z Najpierw Google Drive API. Aby zacząć korzystać z interfejsu Drive Activity API, dowiedz się, jak utworzyć projekt i autoryzacji żądań. Możesz też od razu zacząć o działaniach związanych z Dokumentacja API