Wprowadzenie do Dysku Google API

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 wysyła żądanie danych 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 całej zawartości folderu na Dysku. W przypadku konkretnego żądania możesz ograniczyć odpowiedź według ograniczeń, takich jak zakres czasowy czy typ działania, oraz konsolidować aktywność 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 zasób DriveActivity reprezentuje każdą aktywność:

Wyjaśnienie aktywności na Dysku.

Zasób DriveActivity to zbiór obiektów Action, z których każdy jest niezależny jak zdarzenie. Action zawiera: ActionDetail (np. Create lub Edit), Actor (np. User lub Administrator), Target (na przykład DriveItem lub Drive) oraz Timestamp lub TimeRange.

Zasób DriveActivity zawiera też podsumowanie informacji, np. co Actor i Target ze wszystkich działań, ujednolicony identyfikator Timestamp lub TimeRange oraz najważniejsze lub reprezentatywne ActionDetail z Action.

Więcej informacji znajdziesz w artykule Model danych Drive Activity API (w języku angielskim).

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ę w obiekcie zależy od tego, czy 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 jego aktywności będzie widoczna nie tylko dla niego, 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 ustawiony jako prywatny, uwierzytelniony użytkownik może zobaczyć całą historię aktywności w czasie, gdy miał dostęp, i że jego uprawnienia są teraz ograniczone.
  • Jeśli dokument nie został nigdy 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 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 poczytać o działaniach w dokumentacji API.