- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ApplicationName
- Aktywność
- Wypróbuj
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 |
Reprezentuje identyfikator profilu lub adres e-mail użytkownika, według którego dane mają być filtrowane. Może to być |
applicationName |
Nazwa aplikacji, dla której mają zostać pobrane zdarzenia. |
Parametry zapytania
Parametry | |
---|---|
actorIpAddress |
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 |
Unikalny identyfikator klienta, dla którego chcesz pobrać dane. |
endTime |
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:
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 |
Nazwa zdarzenia, którego dotyczy zapytanie wysłane przez interfejs API. Każdy element |
filters |
Ciąg zapytania Te parametry zdarzenia są powiązane z określonym W poniższych przykładach aktywności na Dysku zwracana lista zawiera wszystkie zdarzenia
Zapytanie
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 |
Określa, ile rekordów aktywności jest wyświetlanych na każdej stronie odpowiedzi. Jeśli np. żądanie ustawia |
orgUnitID |
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 |
Token, który ma być określony na następnej stronie. Raport z wieloma stronami zawiera w odpowiedzi właściwość |
startTime |
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 |
groupIdFilter |
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 ( |
Pola | |
---|---|
kind |
Typ zasobu API. W przypadku raportu aktywności wartość wynosi |
etag |
ETag zasobu. |
items[] |
Każdy zapis aktywności w odpowiedzi. |
nextPageToken |
Token pobierania następnej strony raportu. Wartość |
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 ( |
Pola | |
---|---|
kind |
Typ zasobu API. W przypadku raportu aktywności wartość wynosi |
etag |
ETag wpisu. |
ownerDomain |
Jest to domena, której dotyczy zdarzenie raportu. Na przykład domena konsoli administracyjnej lub właściciela dokumentów aplikacji Dysk. |
ipAddress |
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[] |
Zdarzenia aktywności w raporcie. |
events[].type |
Typ zdarzenia. Usługa lub funkcja Google Workspace, którą zmieni administrator, jest określana we właściwości |
events[].name |
Nazwa zdarzenia. Jest to konkretna nazwa aktywności zgłaszanej przez interfejs API. Każdy element
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[] |
Pary wartości parametrów dla różnych aplikacji. Więcej informacji o parametrach |
events[].parameters[].messageValue |
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ść |
events[].parameters[].messageValue.parameter[] |
Wartości parametrów |
events[].parameters[].name |
Nazwa parametru. |
events[].parameters[].value |
Wartość parametru. |
events[].parameters[].multiValue[] |
Wartości parametru. |
events[].parameters[].intValue |
Liczba całkowita dla parametru. |
events[].parameters[].multiIntValue[] |
Wartości całkowite parametru. |
events[].parameters[].boolValue |
Wartość logiczna parametru. |
events[].parameters[].multiMessageValue[] |
activity.list (lista obiektów) zawiera |
events[].parameters[].multiMessageValue[].parameter[] |
Wartości parametrów |
id |
Unikalny identyfikator każdego rekordu aktywności. |
id.time |
Czas wystąpienia działania. Wartość jest podana w czasie uniksowym (w sekundach). |
id.uniqueQualifier |
Unikalny kwalifikator, jeśli wiele zdarzeń wystąpiło w tym samym czasie. |
id.applicationName |
Nazwa aplikacji, do której należy zdarzenie. Możliwe wartości znajdziesz na powyższej liście aplikacji |
id.customerId |
Niepowtarzalny identyfikator konta Google Workspace. |
actor |
Użytkownik wykonujący działanie. |
actor.profileId |
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 |
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 |
Rodzaj aktora. |
actor.key |
Widoczny tylko wtedy, gdy |