Method: activities.list

string

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

enum (ApplicationName)

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

string

Adres IP hosta, na którym zostało wykonane zdarzenie. Jest to dodatkowy sposób filtrowania podsumowania raportu na podstawie adresu IP użytkownika, którego aktywność została zgłoszona. Ten adres IP może, ale nie musi, odzwierciedlać fizyczną lokalizację użytkownika. Przykładowo adres IP może być adresem serwera proxy użytkownika lub wirtualnej sieci prywatnej (VPN). Ten parametr obsługuje adresy IPv4 oraz IPv6.

string

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

string

Określa koniec zakresu czasu pokazywanego w raporcie. Data jest w formacie 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 pojęcia związane z czasem:

• Data żądania raportu przez interfejs API: data utworzenia i pobrania raportu przez interfejs API.
• Czas rozpoczęcia raportu: początek okresu widocznego w raporcie. Wartość startTime musi być wcześniejsza niż endTime (jeśli została określona) i bieżąca godzina przesłania żądania. W przeciwnym razie interfejs API zwróci błąd.
• Data zakończenia raportu: koniec okresu widocznego w raporcie. Na przykład przedział czasu wydarzeń podsumowanych w raporcie może rozpoczynać się w kwietniu, a kończyć w maju. Sam raport można pobrać w sierpniu.

string

Nazwa zdarzenia, którego dotyczy zapytanie wysyłane przez interfejs API. Każdy element eventName jest powiązany z konkretną usługą lub funkcją Google Workspace, którą interfejs API porządkuje według typów zdarzeń. Przykładem mogą być wydarzenia z Kalendarza Google w raportach aplikacji w konsoli administracyjnej. Struktura type ustawień kalendarza zawiera wszystkie działania z Kalendarza eventName zgłaszane przez interfejs API. Gdy administrator zmieni ustawienie Kalendarza, interfejs API zgłasza tę aktywność w parametrach type i eventName ustawień Kalendarza. Więcej informacji o ciągach zapytań i parametrach eventName znajdziesz na liście nazw zdarzeń w różnych aplikacjach w części applicationName.

string

Ciąg zapytania filters to rozdzielana przecinkami lista złożona z parametrów zdarzenia objętych działaniem operatorów relacyjnych. Parametry zdarzenia mają postać {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

Te parametry zdarzenia są powiązane z konkretnym elementem eventName. Jeśli parametr żądania nie należy do eventName, zwracany jest pusty raport. Więcej informacji o dostępnych polach eventName dla każdej aplikacji i powiązanych z nimi parametrach znajdziesz w tabeli ApplicationName, a następnie w dodatku do odpowiedniej aplikacji przejdź na stronę Zdarzenia związane z aktywnością.

W poniższych przykładach aktywności na Dysku zwracana lista zawiera wszystkie zdarzenia edit, w których wartość parametru doc_id pasuje do warunków zdefiniowanych przez operator relacyjny. W pierwszym przykładzie żądanie zwraca wszystkie edytowane dokumenty o wartości doc_id równej 12345. W drugim przykładzie raport zwróci wszystkie edytowane dokumenty, których wartość doc_id nie jest równa 98765. Operator <> jest zakodowany na potrzeby adresu 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ówna się”.
• <> – „nie równa się”. Musi być zakodowany w adresie URL (%3C%3E).
• < – „mniej niż”. Musi być zakodowany na potrzeby adresu URL (%3C).
• <= – „mniejsze lub równe”. Musi być zakodowany w adresie URL (%3C=).
• > – „większe niż”. Musi być zakodowany w adresie URL (%3E).
• >= – „większe niż lub równe”. Musi być zakodowany w adresie 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 akceptuje tylko jego ostatnią wartość. Dodatkowo, jeśli w żądaniu do interfejsu API podany zostanie nieprawidłowy parametr, API zignoruje go i zwróci odpowiedź odpowiadającą pozostałym prawidłowym parametrom. Jeśli nie zażądano żadnych parametrów, zwracane są wszystkie parametry.

integer

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

string

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

string

Token określający następną stronę. Raport z wieloma stronami zawiera w odpowiedzi właściwość nextPageToken. W kolejnym żądaniu pobierającym następną stronę raportu wpisz wartość nextPageToken w ciągu zapytania pageToken.

string

Określa początek zakresu czasu widocznego w raporcie. Data jest w formacie RFC 3339, na przykład 2010-10-28T10:26:35.000Z. Raport zwraca wszystkie aktywności z okresu od startTime do endTime. Wartość startTime musi być wcześniejsza niż endTime (jeśli została określona) i bieżąca godzina przesłania żądania. W przeciwnym razie interfejs API zwróci błąd.

string

Rozdzielone przecinkami identyfikatory grup (zaciemnione), według których działania użytkowników są filtrowane. Odpowiedź będzie zawierać działania tylko dla tych użytkowników, którzy są częścią co najmniej jednego z wymienionych tutaj identyfikatorów grupy. Format: „id:abc123,id:xyz456”

{
  "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
  }
}

string

Typ zasobu interfejsu API. W przypadku raportu aktywności wartość to audit#activity.

string

ETag wpisu.

string

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

string

Adres IP użytkownika wykonującego działanie. Jest to adres IP użytkownika logującego się w Google Workspace, który może, ale nie musi, odzwierciedlać jego fizyczną lokalizację. Przykładowo adres IP może być adresem serwera proxy użytkownika lub wirtualnej sieci prywatnej (VPN). Interfejs API obsługuje IPv4 oraz IPv6.

object

Zdarzenia aktywności uwzględnione w raporcie.

string

Typ zdarzenia. Usługa lub funkcja Google Workspace zmieniona przez administratora jest określana we właściwości type, która identyfikuje zdarzenie za pomocą właściwości eventName. Pełną listę kategorii type interfejsu API znajdziesz powyżej w sekcji applicationName.

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 dzieli na typy zdarzeń.
Ogólnie w przypadku eventName parametrów żądania:

• Jeśli nie podasz żadnej wartości eventName, raport zwróci wszystkie możliwe wystąpienia wartości eventName.
• Gdy wysyłasz żądanie eventName, odpowiedź interfejsu API zwraca wszystkie aktywności, które zawierają ten element eventName.

object

Pary wartości parametrów dla różnych aplikacji. Więcej informacji o parametrach eventName znajdziesz na liście nazw zdarzeń w różnych aplikacjach w sekcji applicationName.

object

Zagnieżdżone pary wartości parametrów powiązane z tym parametrem. Złożone typy wartości parametru są zwracane w postaci listy wartości parametru. Na przykład parametr address może mieć wartość [{parameter: [{name: city, value: abc}]}]

object (NestedParameter)

Wartości parametrów

string

Nazwa parametru.

string

Wartość parametru w postaci ciągu znaków.

string

Wartości parametru w postaci ciągu znaków.

string (int64 format)

Wartość parametru (liczba całkowita).

string (int64 format)

Wartość parametru (liczba całkowita).

boolean

Wartość logiczna parametru.

object

actions.list z messageValue obiektami.

object (NestedParameter)

Wartości parametrów

object

Unikalny identyfikator każdego rekordu aktywności.

string

Czas wystąpienia działania. Jest to czas uniksowy w sekundach.

string (int64 format)

Unikalny kwalifikator, jeśli wiele wydarzeń dotyczy tego samego czasu.

string

Nazwa aplikacji, do której należy zdarzenie. Możliwe wartości znajdziesz na liście aplikacji powyżej w sekcji applicationName.

string

Unikalny identyfikator konta Google Workspace.

object

Użytkownik wykonujący działanie.

string

Unikalny identyfikator profilu Google Workspace użytkownika, który wykonał czynność. Może brakować tej wartości, jeśli użytkownik nie jest użytkownikiem Google Workspace. Może to być też numer 105250506097979753968, który działa jako identyfikator zastępczy.

string

Podstawowy adres e-mail użytkownika, który wykonał czynność. Tego pola może nie być, jeśli z użytkownikiem nie jest powiązany żaden adres e-mail.

string

Rodzaj aktora.

string

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