Raport aktywności administratora zawiera informacje o aktywności wszystkich administratorów konta w konsoli administracyjnej. Każdy raport korzysta z podstawowego punktu końcowego żądania raportu z parametrami specyficznymi dla raportu, takimi jak nazwa administratora lub konkretne zdarzenie w konsoli administracyjnej. Maksymalny okres, za który możesz wygenerować raport, to ostatnie 180 dni.
Raport o aktywności administratora może być używany wyłącznie w zgodzie z prawem i zgodnie z Umową klienta. Te raporty dotyczą kont Google Workspace, Education i ISP.
Pobieranie wszystkich działań administracyjnych
Aby pobrać raport wszystkich działań administracyjnych wykonanych na koncie, użyj poniższego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. Więcej informacji o ciągach zapytania w żądaniu i właściwościach odpowiedzi znajdziesz w dokumentacji API.
Aby ułatwić czytanie, poniższy przykład zawiera znaki łamania wierszy:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report
Poniższy przykład pokazuje, jak uzyskać raport o wszystkich działaniach administracyjnych na koncie z ostatnich 180 dni, czyli maksymalnego okresu, jaki może obejmować raport.
Ciąg zapytania maxResults określa, że raport zawiera 2 zdarzenia na stronę raportu. Przykład odpowiedzi interfejsu API znajdziesz w sekcji Przykład odpowiedzi JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
Poniższy przykład pobiera raport o wszystkich działaniach administracyjnych klienta z ostatnich 180 dni. Parametr customerId określa, dla którego klienta ma zostać pobrany raport.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
Pobieranie wszystkich działań administratora
Aby pobrać raport o wszystkich działaniach w konsoli administracyjnej wykonanych przez konkretnego administratora, użyj poniższego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. userKey to podstawowy adres e-mail administratora w raporcie. Więcej informacji o ciągach zapytania w żądaniu i właściwościach odpowiedzi znajdziesz w dokumentacji API.
Aby ułatwić czytanie, poniższy przykład zawiera znaki łamania wierszy:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report &filters=event name parameter relational operator parameter value
W tym przykładzie pobierany jest raport o wszystkich zmianach w aplikacji konsoli administracyjnej dokonanych przez użytkownika john@example.com, a odpowiedź jest filtrowana tak, aby zwracać wszystkie działania, w których pole OLD_VALUE ma wartość ALLOW_CAMERA. Przykład odpowiedzi interfejsu API znajdziesz w sekcji Przykład odpowiedzi JSON.
Informacje o działaniach znajdziesz w sekcji Nazwy zdarzeń administratora:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Pobieranie wszystkich aktywności według nazwy zdarzenia
Aby pobrać raport ze wszystkimi działaniami dla określonej nazwy zdarzenia, użyj poniższego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. Informacje o eventName znajdziesz w dokumentacji nazw zdarzeń administratora. Więcej informacji o ciągach zapytania w żądaniu i właściwościach odpowiedzi znajdziesz w dokumentacji API.
Aby ułatwić czytanie, poniższy przykład zawiera znaki łamania wierszy:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
Poniższy przykład pobiera raport dotyczący wszystkich przypadków zmiany nazwiska użytkownika w konsoli administracyjnej. Przykładową odpowiedź interfejsu API znajdziesz w przykładzie odpowiedzi JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Pobieranie wszystkich działań według zdarzenia i administratora
Aby pobrać raport ze wszystkimi zmianami w konsoli administracyjnej dotyczącymi konkretnej nazwy zdarzenia, które zostały wprowadzone przez określonego administratora, użyj poniższego żądania HTTPGET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. userKey to podstawowy adres e-mail administratora w raporcie. Informacje o eventName znajdziesz w dokumentacji nazw zdarzeń administratora. Więcej informacji o ciągach zapytania w żądaniu i właściwościach odpowiedzi znajdziesz w dokumentacji API.
Aby ułatwić czytanie, poniższy przykład zawiera znaki łamania wierszy:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
Poniższy przykład pobiera raport dotyczący wszystkich zmian w konsoli administracyjnej, które zostały wprowadzone przez john@example.com w nazwisku określonego użytkownika. Przykład odpowiedzi interfejsu API znajdziesz w sekcji Przykład odpowiedzi JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Przykładowa odpowiedź JSON raportu o aktywności administratora
Prawidłowa odpowiedź zwraca kod stanu HTTP 200.
Oprócz kodu stanu odpowiedź zawiera raport. Informacje o eventName znajdziesz w dokumentacji nazw zdarzeń administratora. Więcej informacji o ciągach zapytania w adresie URL żądania i właściwościach odpowiedzi znajdziesz w dokumentacji API.
{ "kind": "reports#auditActivities", "nextPageToken": "the next page's token", "items": [ { "kind": "audit#activity", "id": { "time": "2011-06-17T15:39:18.460Z", "uniqueQualifier": "report's unique ID", "applicationName": "admin", "customerId": "C03az79cb" }, "actor": { "callerType": "USER", "email": "liz@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requester in OAuth 2LO requests" }, "ownerDomain": "example.com", "ipAddress": "user's IP address", "events": [ { "type": "GROUP_SETTINGS", "name": "CHANGE_GROUP_SETTING", "parameters": [ { "name": "SETTING_NAME", "value": "WHO_CAN_JOIN", "intValue": "integer value of parameter", "boolValue": "boolean value of parameter" } ] } ] }, { "kind": "audit#activity", "id": { "time": "2011-06-17T15:39:18.460Z", "uniqueQualifier": "reports unique ID", "applicationName": "admin", "customerId": "C03az79cb" }, "actor": { "callerType": "USER", "email": "liz@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requester in an OAuth 2LO request" }, "ownerDomain": "example.com", "ipAddress": "user's IP address", "events": [ { "type": "GROUP_SETTINGS", "name": "CREATE_GROUP", "parameters": [ { "name": "GROUP_EMAIL", "value": "helpdesk@example.com", "intValue": "", "boolValue": "" } ] } ] } ] }