Method: activities.list

Pobiera listę aktywności dla konta i aplikacji określonego klienta, takich jak aplikacja konsoli administracyjnej lub aplikacja Dysk Google. Więcej informacji znajdziesz w przewodnikach przeznaczonych dla administratorów i na temat raportów aktywności na Dysku Google. Więcej informacji o parametrach raportu aktywności znajdziesz w przewodnikach po parametrach aktywności.

Żądanie HTTP

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
userKey or all

string

Reprezentuje identyfikator profilu lub adres e-mail użytkownika, według którego dane mają być filtrowane. Może to być all w przypadku wszystkich informacji albo userKey w przypadku unikalnego identyfikatora profilu Google Workspace lub podstawowego adresu e-mail użytkownika. Nie może być usuniętym użytkownikiem. W przypadku usuniętego konta użytkownika wywołaj users.list w interfejsie Directory API z użyciem funkcji showDeleted=true, a następnie użyj zwróconego ID jako wartości userKey.
applicationName

enum (ApplicationName)

Nazwa aplikacji, dla której mają zostać pobrane zdarzenia.

Parametry zapytania

Parametry
actorIpAddress

string

Adres IP hosta, na którym miało miejsce zdarzenie. To dodatkowy sposób filtrowania podsumowania raportu na podstawie adresu IP użytkownika, którego aktywność jest zgłaszana. Adres ten może, ale nie musi, odzwierciedlać fizyczną lokalizację użytkownika. Na przykład adres IP może być adresem serwera proxy użytkownika lub wirtualnej sieci prywatnej (VPN). Ten parametr obsługuje zarówno wersję adresu IPv4, jak i IPv6.
customerId

string

Unikalny identyfikator klienta, dla którego chcesz pobrać dane.
endTime

string

Określa koniec zakresu czasu wskazanego w raporcie. Data ma format RFC 3339, na przykład 2010-10-28T10:26:35.000Z. Wartość domyślna to przybliżony czas żądania do interfejsu API. Raport interfejsu API obejmuje 3 podstawowe koncepcje czasu:

  • Data żądania raportu przez interfejs API: data utworzenia i pobrania raportu przez interfejs API.
  • Czas rozpoczęcia raportu: początek okresu wskazanego w raporcie. Wartość startTime musi być przed datą endTime (jeśli została określona) i czasem wysyłania żądania. W przeciwnym razie interfejs API zwróci błąd.
  • Czas zakończenia raportu: koniec okresu wskazanego w raporcie. Na przykład okres zdarzeń podsumowanych w raporcie może rozpoczynać się w kwietniu, a kończyć w maju. Raport można zamówić w sierpniu.
Jeśli endTime nie zostanie określony, raport zwróci wszystkie działania z okresu startTime do aktualnej godziny lub z ostatnich 180 dni, jeśli startTime obejmuje ponad 180 dni wstecz.
eventName

string

Nazwa zdarzenia, którego dotyczy zapytanie wysłane przez interfejs API. Każdy element eventName jest powiązany z konkretną usługą lub funkcją Google Workspace, którą interfejs API podzieli na typy zdarzeń. Przykładem mogą być wydarzenia Kalendarza Google w raportach aplikacji konsoli administracyjnej. Struktura type w Ustawieniach kalendarza zawiera wszystkie aktywności eventName Kalendarza raportowane przez interfejs API. Gdy administrator zmieni ustawienie Kalendarza, interfejs API zgłasza tę aktywność w parametrach type i eventName w ustawieniach kalendarza. Więcej informacji o ciągach zapytań i parametrach eventName znajdziesz powyżej na liście nazw zdarzeń używanych w różnych aplikacjach w sekcji applicationName.
filters

string

Ciąg zapytania filters to rozdzielona przecinkami lista złożona z parametrów zdarzeń zmienianych przez operatory relacyjne. Parametry zdarzenia mają postać {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

Te parametry zdarzenia są powiązane z określonym eventName. Jeśli parametr żądania nie należy do interfejsu eventName, zwracany jest pusty raport. Aby dowiedzieć się więcej o polach eventName dostępnych w przypadku każdej aplikacji i powiązanych z nimi parametrów, otwórz tabelę ApplicationName, a potem w Dodatku przejdź do strony zdarzeń działań w dodatku dla wybranej aplikacji.

W poniższych przykładach aktywności na Dysku zwracana lista zawiera wszystkie zdarzenia edit, w przypadku których wartość parametru doc_id spełnia warunki określone przez operatora relacyjnego. W pierwszym przykładzie żądanie zwraca wszystkie edytowane dokumenty o wartości doc_id równej 12345. W drugim przykładzie raport zwraca wszystkie edytowane dokumenty, w których wartość doc_id nie jest równa 98765. Operator <> jest zakodowany w adresie URL w ciągu zapytania żądania (%3C%3E):

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

Zapytanie filters obsługuje te operatory relacyjne:

  • == – „równe”.
  • <> – „nie równa się”. Musi być zakodowanym adresem URL (%3C%3E).
  • < – „mniejsze niż”. Musi być zakodowanym adresem URL (%3C).
  • <= – „mniejsze lub równe”. Musi być zakodowany na potrzeby adresu URL (%3C=).
  • > – „większe niż”. Musi być zakodowanym adresem URL (%3E).
  • >= – „większe niż lub równe”. Musi być zakodowanym adresem URL (%3E=).

Uwaga: interfejs API nie akceptuje wielu wartości tego samego parametru. Jeśli parametr zostanie podany więcej niż raz w żądaniu do interfejsu API, interfejs API zaakceptuje tylko jego ostatnią wartość. Poza tym, jeśli w żądaniu do interfejsu API zostanie podany nieprawidłowy parametr, interfejs API zignoruje ten parametr i zwróci odpowiedź odpowiadającą pozostałym prawidłowym parametrom. Jeśli nie zostanie zażądane żadne parametry, zwracane zostaną wszystkie parametry.
maxResults

integer

Określa, ile rekordów aktywności jest wyświetlanych na każdej stronie odpowiedzi. Jeśli np. żądanie ustawia maxResults=1, a raport zawiera 2 działania, składa się on z 2 stron. Właściwość nextPageToken odpowiedzi zawiera token na drugiej stronie. Ciąg zapytania maxResults jest w żądaniu opcjonalny. Wartością domyślną jest 1000.
orgUnitID

string

Identyfikator jednostki organizacyjnej, której ma dotyczyć raport. Rekordy aktywności będą wyświetlane tylko w przypadku użytkowników należących do określonej jednostki organizacyjnej.

pageToken

string

Token, który ma być określony na następnej stronie. Raport z wieloma stronami zawiera w odpowiedzi właściwość nextPageToken. W kolejnym żądaniu, by wyświetlić następną stronę raportu, wpisz wartość nextPageToken w ciągu zapytania pageToken.
startTime

string

Określa początek zakresu czasu wskazanego w raporcie. Data ma format RFC 3339, na przykład 2010-10-28T10:26:35.000Z. Raport zawiera wszystkie aktywności od startTime do endTime. Wartość startTime musi być przed datą endTime (jeśli została określona) i czasem wysyłania żądania. W przeciwnym razie interfejs API zwróci błąd.
groupIdFilter

string

Rozdzielone przecinkami identyfikatory grup (zaciemnione), według których są filtrowane aktywności użytkowników. Oznacza to, że odpowiedź będzie zawierać działania tylko tych użytkowników, którzy należą do co najmniej jednego z wymienionych tutaj identyfikatorów grupy. Format: "id:abc123,id:xyz456"

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Szablon JSON dla zbioru aktywności.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
Pola
kind

string

Typ zasobu API. W przypadku raportu aktywności wartość wynosi reports#activities.
etag

string

ETag zasobu.
items[]

object (Activity)

Każdy zapis aktywności w odpowiedzi.
nextPageToken

string

Token pobierania następnej strony raportu. Wartość nextPageToken jest używana w ciągu zapytania pageToken żądania.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

Więcej informacji znajdziesz w przewodniku po autoryzacji.

ApplicationName

Wartości w polu enum
access_transparency

Raporty aktywności związanej z Przejrzystością dostępu w Google Workspace zawierają informacje o różnych typach zdarzeń związanych z Przejrzystością dostępu.
admin

Raporty aktywności aplikacji w konsoli administracyjnej zawierają informacje o koncie dotyczące różnych typów zdarzeń związanych z aktywnością administratora.
calendar

Raporty o aktywności aplikacji Kalendarz Google zawierają informacje o różnych wydarzeniach związanych z aktywnością z Kalendarza.
chat Raporty o aktywności w Google Chat zawierają informacje o różnych zdarzeniach związanych z aktywnością w Google Chat.
drive

Raporty o aktywności aplikacji Dysk Google zawierają informacje o różnych zdarzeniach związanych z aktywnością na Dysku Google. Raport dotyczący aktywności na Dysku jest dostępny tylko dla klientów korzystających z Google Workspace Business i Enterprise.
gcp Raporty aktywności aplikacji Google Cloud Platform zwracają informacje o różnych zdarzeniach związanych z działaniami GCP.
gplus Raporty aktywności aplikacji Google+ zawierają informacje o różnych zdarzeniach związanych z aktywnością w Google+.
groups

Raporty aktywności aplikacji Grupy dyskusyjne Google zwracają informacje o różnych zdarzeniach związanych z aktywnością Grup dyskusyjnych.
groups_enterprise

Raporty aktywności Grup dyskusyjnych Google Enterprise zawierają informacje o różnych zdarzeniach związanych z aktywnością w grupach firmowych.
jamboard Raporty o aktywności Jamboarda zawierają informacje o różnych zdarzeniach związanych z aktywnością na Jamboardzie.
login

Raporty aktywności aplikacji Logowanie zwracają informacje o koncie dotyczące różnych typów zdarzeń związanych z aktywnością logowania.
meet Raport aktywności kontroli Meet zawiera informacje o różnych typach zdarzeń związanych z kontrolą Meet.
mobile Raport aktywności związanej z kontrolą urządzeń zawiera informacje o różnych typach zdarzeń związanych z kontrolą urządzeń.
rules

Raport aktywności związanej z regułami zawiera informacje o różnych typach zdarzeń związanych z regułami.
saml

Raport aktywności SAML zawiera informacje o różnych typach zdarzeń związanych z aktywnością SAML.
token

Raporty o aktywności aplikacji Token zwracają informacje o koncie o różnych typach zdarzeń związanych z aktywnością tokena.
user_accounts

Raporty o aktywności kont użytkowników zawierają informacje o koncie związane z różnymi typami zdarzeń związanych z kontami użytkowników.
context_aware_access

Raporty aktywności dostępu zależnego od kontekstu zwracają informacje o zdarzeniach odmowy dostępu zależnego od kontekstu przez reguły dostępu zależnego od kontekstu.
chrome

Raporty aktywności Chrome zawierają informacje o zdarzeniach dotyczących przeglądarki Chrome i systemu operacyjnego Chrome.
data_studio Raporty o aktywności w Studiu danych zawierają informacje o różnych typach zdarzeń związanych z aktywnością w Studiu danych.
keep Raporty o aktywności aplikacji Keep zawierają informacje o różnych zdarzeniach związanych z aktywnością w Google Keep. Raport o aktywności w Keep jest dostępny tylko dla klientów korzystających z Google Workspace Business i Enterprise.
vault Raporty o aktywności w Vault zawierają informacje o różnych typach zdarzeń aktywności w Vault.

Aktywność

Szablon JSON dla zasobu aktywności.

Zapis JSON 
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}
Pola
kind

string

Typ zasobu API. W przypadku raportu aktywności wartość wynosi audit#activity.
etag

string

ETag wpisu.
ownerDomain

string

Jest to domena, której dotyczy zdarzenie raportu. Na przykład domena konsoli administracyjnej lub właściciela dokumentów aplikacji Dysk.
ipAddress

string

Adres IP użytkownika wykonującego działanie. Jest to adres IP użytkownika podczas logowania się w Google Workspace, który może, ale nie musi, odzwierciedlać jego fizyczną lokalizację. Na przykład adres IP może być adresem serwera proxy użytkownika lub wirtualnej sieci prywatnej (VPN). Interfejs API obsługuje protokoły IPv4 i IPv6.
events[]

object

Zdarzenia aktywności w raporcie.
events[].type

string

Typ zdarzenia. Usługa lub funkcja Google Workspace, którą zmieni administrator, jest określana we właściwości type. Pozwala ona identyfikować zdarzenie za pomocą właściwości eventName. Pełną listę kategorii type w interfejsie API znajdziesz powyżej na liście nazw zdarzeń dla różnych aplikacji w applicationName.
events[].name

string

Nazwa zdarzenia. Jest to konkretna nazwa aktywności zgłaszanej przez interfejs API. Każdy element eventName jest powiązany z konkretną usługą lub funkcją Google Workspace, którą interfejs API podzieli na typy zdarzeń.
Ogólnie dla parametrów żądania eventName:

  • Jeśli nie podano eventName, raport zwraca wszystkie możliwe wystąpienia eventName.
  • Gdy wyślesz żądanie eventName, w odpowiedzi interfejsu API zostaną zwrócone wszystkie działania, które zawierają ten obiekt eventName.

Więcej informacji o właściwościach eventName znajdziesz powyżej na liście nazw zdarzeń dla różnych aplikacji w usłudze applicationName.
events[].parameters[]

object

Pary wartości parametrów dla różnych aplikacji. Więcej informacji o parametrach eventName znajdziesz powyżej na liście nazw zdarzeń dla różnych aplikacji w narzędziu applicationName.
events[].parameters[].messageValue

object

Pary wartości zagnieżdżonych parametrów powiązane z tym parametrem. Typ wartości zespolonej parametru jest zwracany w formie listy wartości parametru. Na przykład parametr address może mieć wartość [{parameter: [{name: city, value: abc}]}].
events[].parameters[].messageValue.parameter[]

object (NestedParameter)

Wartości parametrów
events[].parameters[].name

string

Nazwa parametru.
events[].parameters[].value

string

Wartość parametru.
events[].parameters[].multiValue[]

string

Wartości parametru.
events[].parameters[].intValue

string (int64 format)

Liczba całkowita dla parametru.
events[].parameters[].multiIntValue[]

string (int64 format)

Wartości całkowite parametru.
events[].parameters[].boolValue

boolean

Wartość logiczna parametru.
events[].parameters[].multiMessageValue[]

object

activity.list (lista obiektów) zawiera messageValue obiekt.
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

Wartości parametrów
id

object

Unikalny identyfikator każdego rekordu aktywności.
id.time

string

Czas wystąpienia działania. Wartość jest podana w czasie uniksowym (w sekundach).
id.uniqueQualifier

string (int64 format)

Unikalny kwalifikator, jeśli wiele zdarzeń wystąpiło w tym samym czasie.
id.applicationName

string

Nazwa aplikacji, do której należy zdarzenie. Możliwe wartości znajdziesz na powyższej liście aplikacji applicationName.
id.customerId

string

Niepowtarzalny identyfikator konta Google Workspace.
actor

object

Użytkownik wykonujący działanie.
actor.profileId

string

Unikalny identyfikator profilu Google Workspace użytkownika, który wykonał czynność. Ta wartość może być niedostępna, jeśli użytkownik nie jest użytkownikiem Google Workspace, lub może być liczbą 105250506097979753968, która działa jako identyfikator zastępczy.
actor.email

string

Podstawowy adres e-mail użytkownika, który wykonał czynność. Pole może nie zawierać adresu e-mail użytkownika, który wykonał czynność.
actor.callerType

string

Rodzaj aktora.
actor.key

string

Widoczny tylko wtedy, gdy callerType ma wartość KEY. Może to być consumer_key żądającego w przypadku żądań do interfejsu OAuth 2LO API lub identyfikator kont robota.