- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ApplicationName
- Aktywność
- NetworkInfo
- ResourceDetails
- AppliedLabel
- FieldValue
- TextListValue
- SelectionValue
- SelectionListValue
- UserValue
- UserListValue
- Data
- Uzasadnienie
- Wypróbuj
Pobiera listę działań na koncie i w aplikacji konkretnego klienta, np. w aplikacji konsoli administracyjnej lub w aplikacji Dysku Google. Więcej informacji znajdziesz w przewodnikach po raportach aktywności administratora i 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 |
Zawiera identyfikator profilu lub adres e-mail użytkownika, według którego mają być filtrowane dane. Może to być |
applicationName |
Nazwa aplikacji, dla której mają zostać pobrane zdarzenia. |
Parametry zapytania
Parametry | |
---|---|
actorIpAddress |
Adres IP hosta, na którym wykonano zdarzenie. Jest to dodatkowy sposób filtrowania podsumowania raportu za pomocą adresu IP użytkownika, którego aktywność jest raportowana. Ten adres IP może odzwierciedlać fizyczną lokalizację użytkownika, ale nie musi. Może to być na przykład adres serwera proxy użytkownika lub adres wirtualnej sieci prywatnej (VPN). Ten parametr obsługuje wersje adresów IPv4 i IPv6. |
customerId |
Unikalny identyfikator klienta, dla którego chcesz pobrać dane. |
endTime |
Określa koniec zakresu czasu wyświetlanego w raporcie. Data jest podana w formacie RFC 3339, np. 2010-10-28T10:26:35.000Z. Wartością domyślną jest przybliżony czas żądania interfejsu API. Raport API zawiera 3 podstawowe pojęcia związane z czasem:
endTime , raport zwróci wszystkie działania od daty startTime do bieżącego czasu lub z ostatnich 180 dni, jeśli data startTime przypada na okres sprzed ponad 180 dni. W przypadku próśb dotyczących Gmaila należy podać wartości startTime i endTime , a różnica między nimi nie może być większa niż 30 dni.
|
eventName |
Nazwa zdarzenia, o którego dane wysyła zapytanie interfejs API. Każdy |
filters |
Te parametry zdarzenia są powiązane z konkretnym W poniższych przykładach aktywności na Dysku zwrócona lista zawiera wszystkie zdarzenia
Zapytanie
Uwaga: interfejs API nie akceptuje wielu wartości tego samego parametru. Jeśli parametr zostanie podany w żądaniu API więcej niż raz, interfejs API zaakceptuje tylko jego ostatnią wartość. Jeśli w żądaniu do interfejsu API podano nieprawidłowy parametr, interfejs API ignoruje ten parametr i zwraca odpowiedź odpowiadającą pozostałym prawidłowym parametrom. Jeśli nie zażądasz żadnych parametrów, zostaną zwrócone wszystkie. |
maxResults |
Określa, ile rekordów aktywności jest wyświetlanych na każdej stronie odpowiedzi. Jeśli na przykład żądanie zawiera |
orgUnitID |
Identyfikator jednostki organizacyjnej, której dotyczy raport. Rekordy aktywności będą wyświetlane tylko w przypadku użytkowników należących do określonej jednostki organizacyjnej. |
pageToken |
Token określający następną stronę. Raport z wieloma stronami ma w odpowiedzi właściwość |
startTime |
Określa początek zakresu czasu wyświetlanego w raporcie. Data jest podana w formacie RFC 3339, np. 2010-10-28T10:26:35.000Z. Raport zawiera wszystkie działania od |
groupIdFilter |
Identyfikatory grup (zaciemnione) oddzielone przecinkami, według których filtrowane są działania użytkowników, tzn. odpowiedź będzie zawierać działania tylko tych użytkowników, którzy należą do co najmniej jednego z wymienionych tu identyfikatorów grup. Format: „id:abc123,id:xyz456” . |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Szablon JSON dla kolekcji działań.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
Pola | |
---|---|
kind |
Typ zasobu interfejsu API. W przypadku raportu o aktywności wartość to |
etag |
ETag zasobu. |
items[] |
Każdy rekord aktywności w odpowiedzi. |
nextPageToken |
Token do pobierania kolejnej 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 Przejrzystości dostępu w Google Workspace zawierają informacje o różnych rodzajach zdarzeń aktywności Przejrzystości dostępu. |
admin |
Raporty aktywności aplikacji konsoli administracyjnej zawierają informacje o kontach dotyczące różnych typów zdarzeń związanych z aktywnością administratora. |
calendar |
Raporty aktywności aplikacji Kalendarz Google zawierają informacje o różnych wydarzeniach związanych z aktywnością w Kalendarzu. |
chat |
Raporty aktywności w Google Chat zwracają informacje o różnych zdarzeniach związanych z aktywnością w Google Chat. |
drive |
Raporty aktywności aplikacji Dysk Google zawierają informacje o różnych zdarzeniach związanych z aktywnością na Dysku Google. Raport aktywności na Dysku jest dostępny tylko dla klientów Google Workspace Business i Enterprise. |
gcp |
Raporty o aktywności aplikacji Google Cloud Platform zawierają informacje o różnych zdarzeniach związanych z aktywnością w GCP. |
gmail |
Raporty dotyczące aktywności w aplikacji Gmail zawierają informacje o różnych zdarzeniach związanych z aktywnością w Gmailu. |
gplus |
Raporty aktywności aplikacji Google+ zawierają informacje o różnych zdarzeniach związanych z aktywnością w Google+. |
groups |
Raporty dotyczące aktywności w aplikacji Grupy dyskusyjne Google zawierają informacje o różnych zdarzeniach związanych z aktywnością w Grupach. |
groups_enterprise |
Raporty aktywności Grup dyskusyjnych Google Enterprise zawierają informacje o różnych zdarzeniach związanych z aktywnością w grupach dyskusyjnych. |
jamboard |
Raporty aktywności Jamboard zwracają informacje o różnych zdarzeniach związanych z aktywnością Jamboard. |
login |
Raporty aktywności aplikacji Logowanie zawierają informacje o kontach dotyczące różnych typów zdarzeń związanych z aktywnością logowania. |
meet |
Raport Kontrola aktywności w Meet zawiera informacje o różnych typach zdarzeń związanych z kontrolą aktywności w Meet. |
mobile |
Raport aktywności Kontrola urządzenia zawiera informacje o różnych typach zdarzeń związanych z aktywnością Kontrola urządzenia. |
rules |
Raport Aktywność związana z regułami zawiera informacje o różnych typach zdarzeń związanych z aktywnością reguł. |
saml |
Raport o aktywności SAML zawiera informacje o różnych typach zdarzeń związanych z aktywnością SAML. |
token |
Raporty aktywności aplikacji Token zwracają informacje o koncie dotyczące różnych typów zdarzeń związanych z aktywnością tokena. |
user_accounts |
Raporty aktywności aplikacji Konta użytkowników zawierają informacje o kontach dotyczące różnych typów wydarzeń związanych z aktywnością na kontach użytkowników. |
context_aware_access |
Raporty aktywności związane z dostępem zależnym od kontekstu zawierają informacje o zdarzeniach odrzucenia dostępu użytkowników z powodu reguł dostępu zależnego od kontekstu. |
chrome |
Raporty o aktywności w Chrome zawierają informacje o zdarzeniach w przeglądarce Chrome i Chrome OS. |
data_studio |
Raporty aktywności w Studiu danych zawierają informacje o różnych typach zdarzeń związanych z aktywnością w Studiu danych. |
keep |
Raporty aktywności aplikacji Keep zawierają informacje o różnych zdarzeniach związanych z aktywnością w Google Keep. Raport aktywności w Keep jest dostępny tylko dla klientów Google Workspace Business i Enterprise. |
vault |
Raporty aktywności w Vault zawierają informacje o różnych typach zdarzeń związanych z aktywnością w Vault. |
gemini_in_workspace_apps |
Raporty aktywności Gemini w Workspace zawierają informacje o różnych typach zdarzeń związanych z aktywnością w Gemini, które zostały wykonane przez użytkowników w aplikacji Workspace. |
classroom |
Raporty aktywności w Classroom zawierają informacje o różnych typach zdarzeń związanych z aktywnością w Classroom. |
Aktywność
Szablon JSON zasobu działania.
Zapis JSON |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
Pola | |
---|---|
kind |
Typ zasobu interfejsu API. W przypadku raportu o aktywności wartość to |
etag |
ETag wpisu. |
ownerDomain |
Jest to domena, której dotyczy zdarzenie w raporcie. Na przykład domena konsoli administracyjnej lub właściciela dokumentu w aplikacji Dysk. |
ipAddress |
Adres IP użytkownika, który wykonał działanie. Jest to adres IP użytkownika podczas logowania się w Google Workspace, który może, ale nie musi odzwierciedlać fizycznej lokalizacji użytkownika. Może to być na przykład adres serwera proxy użytkownika lub adres wirtualnej sieci prywatnej (VPN). Interfejs API obsługuje IPv4 i IPv6. |
events[] |
zdarzenia aktywności w raporcie. |
events[].type |
Typ zdarzenia. Usługa lub funkcja Google Workspace, którą administrator zmienia, jest identyfikowana we właściwości |
events[].name |
Nazwa zdarzenia. Jest to konkretna nazwa aktywności zgłoszona przez interfejs API. Każdy
Więcej informacji o eventName właściwościach znajdziesz na liście nazw zdarzeń w różnych aplikacjach powyżej w applicationName .
|
events[].parameters[] |
Pary wartości parametrów dla różnych aplikacji. Więcej informacji o parametrach |
events[].parameters[].messageValue |
Zagnieżdżone pary wartości parametrów powiązane z tym parametrem. Złożone typy wartości parametrów są zwracane jako lista wartości parametrów. Na przykład parametr adresu może mieć wartość |
events[].parameters[].messageValue.parameter[] |
Wartości parametrów |
events[].parameters[].name |
Nazwa parametru. |
events[].parameters[].value |
Wartość parametru w postaci ciągu znaków. |
events[].parameters[].multiValue[] |
Wartości ciągu parametru. |
events[].parameters[].intValue |
Wartość parametru jako liczba całkowita. |
events[].parameters[].multiIntValue[] |
Wartości parametru w postaci liczb całkowitych. |
events[].parameters[].boolValue |
Wartość logiczna parametru. |
events[].parameters[].multiMessageValue[] |
activities.list z |
events[].parameters[].multiMessageValue[].parameter[] |
Wartości parametrów |
events[].resourceIds[] |
Identyfikatory zasobów powiązane ze zdarzeniem. |
id |
Unikalny identyfikator każdego rekordu aktywności. |
id.time |
Czas wystąpienia aktywności. Jest to czas epoki uniksowej w sekundach. |
id.uniqueQualifier |
Unikalny kwalifikator, jeśli kilka zdarzeń ma ten sam czas. |
id.applicationName |
Nazwa aplikacji, do której należy zdarzenie. Możliwe wartości znajdziesz na liście aplikacji powyżej w |
id.customerId |
Unikalny identyfikator konta Google Workspace. |
actor |
Użytkownik, który wykonuje działanie. |
actor.profileId |
Niepowtarzalny identyfikator profilu Google Workspace aktora. Ta wartość może być nieobecna, jeśli aktor nie jest użytkownikiem Google Workspace, lub może to być numer 105250506097979753968, który pełni rolę identyfikatora zastępczego. |
actor.email |
Podstawowy adres e-mail użytkownika, który wykonał działanie. Może nie występować, jeśli z użytkownikiem nie jest powiązany żaden adres e-mail. |
actor.callerType |
Typ użytkownika, który wykonał czynność. |
actor.key |
Występuje tylko wtedy, gdy |
actor.applicationInfo |
Szczegóły aplikacji, która była wykonawcą działania. |
actor.applicationInfo.oauthClientId |
Identyfikator klienta OAuth aplikacji innej firmy użytej do wykonania działania. |
actor.applicationInfo.applicationName |
Nazwa aplikacji użytej do wykonania działania. |
actor.applicationInfo.impersonation |
Czy aplikacja podszywała się pod użytkownika. |
networkInfo |
Informacje o sieci użytkownika, który wykonał działanie. |
resourceDetails[] |
Szczegóły zasobu, na którym wykonano działanie. |
NetworkInfo
Informacje o sieci użytkownika, który wykonał działanie.
Zapis JSON |
---|
{ "ipAsn": [ integer ], "regionCode": string, "subdivisionCode": string } |
Pola | |
---|---|
ipAsn[] |
Adres IP użytkownika, który wykonał działanie. |
regionCode |
Kod regionu w formacie ISO 3166-1 alfa-2 użytkownika, który wykonuje działanie. |
subdivisionCode |
Kod regionu zgodny ze standardem ISO 3166-2 (stany i prowincje) w przypadku krajów użytkownika wykonującego działanie. |
ResourceDetails
Szczegóły zasobu, na którym wykonano działanie.
Zapis JSON |
---|
{
"id": string,
"title": string,
"type": string,
"appliedLabels": [
{
object ( |
Pola | |
---|---|
id |
Identyfikator zasobu. |
title |
Tytuł zasobu. Na przykład w przypadku dokumentu na Dysku będzie to tytuł dokumentu. W przypadku e-maila będzie to temat. |
type |
Typ zasobu – dokument, e-mail, wiadomość na czacie |
appliedLabels[] |
activities.list of labels applied on the resource |
relation |
Określa relację zasobu ze zdarzeniami. |
AppliedLabel
Szczegóły etykiety zastosowanej do zasobu.
Zapis JSON |
---|
{ "id": string, "title": string, "fieldValues": [ { object ( |
Pola | |
---|---|
id |
Identyfikator etykiety – tylko identyfikator etykiety, a nie pełna nazwa zasobu OnePlatform. |
title |
Tytuł etykiety |
fieldValues[] |
activities.list of fields which are part of the label and have been set by the user. Jeśli etykieta ma pole, które nie zostało ustawione przez użytkownika, nie będzie jej na tej liście. |
reason |
Przyczyna zastosowania etykiety do zasobu. |
FieldValue
Szczegóły wartości pola ustawionej przez użytkownika dla danej etykiety.
Zapis JSON |
---|
{ "id": string, "displayName": string, "type": string, "reason": { object ( |
Pola | |
---|---|
id |
Identyfikator pola |
displayName |
Wyświetlana nazwa pola. |
type |
Typ pola |
reason |
Przyczyna zastosowania pola do etykiety. |
Pole unii value . Wartości przechowywane w polu value mogą być tylko jednymi z tych: |
|
unsetValue |
Jeśli pole nie jest ustawione, ta wartość będzie miała wartość true. |
longTextValue |
Ustawianie długiej wartości tekstowej. |
textValue |
Ustawianie wartości tekstowej. |
textListValue |
Ustawianie wartości listy tekstowej. |
selectionValue |
Ustawianie wartości wyboru przez wybranie jednej wartości z menu. |
selectionListValue |
Ustawianie wartości listy wyboru przez wybranie wielu wartości z menu. |
integerValue |
Ustawianie wartości całkowitej. |
userValue |
Ustawianie wartości użytkownika przez wybranie jednego użytkownika. |
userListValue |
Ustawianie wartości listy użytkowników przez wybranie wielu użytkowników. |
dateValue |
Ustawianie wartości daty. |
TextListValue
Ustawianie wartości listy tekstowej.
Zapis JSON |
---|
{ "values": [ string ] } |
Pola | |
---|---|
values[] |
activities.list of text values. |
SelectionValue
Ustawianie wartości wyboru przez wybranie jednej wartości z menu.
Zapis JSON |
---|
{ "id": string, "displayName": string, "badged": boolean } |
Pola | |
---|---|
id |
Identyfikator wyboru. |
displayName |
Wyświetlana nazwa wyboru. |
badged |
Czy wybór ma plakietkę. |
SelectionListValue
Ustawianie wartości listy wyboru przez wybranie wielu wartości z menu.
Zapis JSON |
---|
{
"values": [
{
object ( |
Pola | |
---|---|
values[] |
activities.list of selections. |
UserValue
Ustawianie wartości użytkownika przez wybranie jednego użytkownika.
Zapis JSON |
---|
{ "email": string } |
Pola | |
---|---|
email |
Adres e-mail użytkownika. |
UserListValue
Ustawianie wartości listy użytkowników przez wybranie wielu użytkowników.
Zapis JSON |
---|
{
"values": [
{
object ( |
Pola | |
---|---|
values[] |
activities.list of users. |
Data
Reprezentuje całą lub częściową datę kalendarzową, np. datę urodzin. Pora dnia i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podana w kalendarzu gregoriańskim. Może to być jedna z tych wartości:
- Pełna data z wartościami roku, miesiąca i dnia różnymi od zera.
- Miesiąc i dzień z rokiem zerowym (np. rocznica).
- Sam rok, z miesiącem i dniem o wartości zero.
- Rok i miesiąc z zerowym dniem (np. data ważności karty kredytowej).
Powiązane typy:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Zapis JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Pola | |
---|---|
year |
Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, aby określić datę bez roku. |
month |
Miesiąc roku. Wartość musi mieścić się w przedziale od 1 do 12 lub wynosić 0, jeśli chcesz określić rok bez miesiąca i dnia. |
day |
Dzień miesiąca. Musi być liczbą od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub liczbą od 0 do 31, jeśli chcesz podać tylko rok lub rok i miesiąc, w których dzień nie ma znaczenia. |
Przyczyna
Przyczyna zastosowania etykiety lub pola.
Zapis JSON |
---|
{ "reasonType": string } |
Pola | |
---|---|
reasonType |
Typ powodu. |