Wprowadzenie do interfejsu Google Drive Activity API

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:

Wyjaśnienie dotyczące aktywności na Dysku.

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 ActorTarget ze wszystkich działań, ujednolicony Timestamp lub TimeRange oraz najważniejsze lub reprezentatywne ActionDetailAction.

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.