- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ApplicationName
Zacznij otrzymywać powiadomienia o aktywności na koncie. Więcej informacji znajdziesz w artykule Odbieranie powiadomień push.
Żądanie HTTP
POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch
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 zawiera wystąpienie elementu SubscriptionChannel
.
Treść odpowiedzi
Kanał powiadomień używany do oglądania informacji o zmianach zasobów.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "id": string, "token": string, "expiration": string, "type": string, "address": string, "payload": boolean, "params": { string: string, ... }, "resourceId": string, "resourceUri": string, "kind": string } |
Pola | |
---|---|
id |
UUID lub podobny unikalny ciąg znaków, który identyfikuje ten kanał. |
token |
Dowolny ciąg znaków dostarczany na adres docelowy w każdym powiadomieniu wysyłanym na ten kanał. Opcjonalnie. |
expiration |
Data i godzina wygaśnięcia kanału powiadomień, wyrażone w postaci sygnatury czasowej uniksowej (w milisekundach). Opcjonalnie. |
type |
Typ mechanizmu przesyłania używany w tym kanale. Wartość powinna być ustawiona na |
address |
Adres, na który są dostarczane powiadomienia dotyczące tego kanału. |
payload |
Wartość logiczna wskazująca, czy potrzebny jest ładunek. Ładunek to dane wysyłane w treści wiadomości HTTP POST, PUT lub PATCH i zawierające ważne informacje o żądaniu. Opcjonalnie. |
params |
Dodatkowe parametry kontrolujące działanie kanału wyświetlania. Opcjonalnie. Obiekt zawierający listę par |
resourceId |
Nieprzezroczysty identyfikator identyfikujący zasób, który jest oglądany na tym kanale. Stabilność w różnych wersjach interfejsu API. |
resourceUri |
Identyfikator wersji obserwowanego zasobu. |
kind |
Identyfikuje to jako kanał powiadomień służący do monitorowania zmian w zasobie „ |
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
Nazwa aplikacji, dla której mają zostać pobrane zdarzenia.
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 Google Workspace 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. |