Raport aktywności administratora zawiera informacje o aktywnościach w konsoli administracyjnej wszystkich administratorów Twojego konta. Każdy raport używa podstawowego żądania punktu końcowego raportu z parametrami związanymi z raportem, takimi jak nazwa administratora lub konkretne zdarzenie w konsoli administracyjnej. Maksymalny zakres czasowy każdego raportu to 180 dni.
W tym dokumencie założono, że udało Ci się ukończyć wstępne czynności konfiguracyjne.
Raportu aktywności administratora można używać tylko do celów prawnych 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 związanych z kontem, użyj poniższego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. Więcej informacji o ciągach zapytania i właściwościach odpowiedzi znajdziesz w przewodniku po interfejsie API. Aby zwiększyć czytelność, przykładowy kod ma taki format:
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 zawiera raport o wszystkich działaniach administracyjnych związanych z Twoim kontem z ostatnich 180 dni (czyli maksymalny okres objęty raportem). Ciąg zapytania maxResults określa, że raport zawiera 2 zdarzenia na stronie raportu. Przykład odpowiedzi API znajdziesz w przykładzie odpowiedzi JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
Poniższy przykład zawiera raport o wszystkich działaniach administracyjnych klienta w ciągu ostatnich 180 dni. customerId określa klienta, którego raport ma zostać pobrany.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
Pobierz całą aktywność według administratora
Aby pobrać raport o wszystkich działaniach w konsoli administracyjnej wykonanych przez określonego administratora, użyj tego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. userKey to podstawowy adres e-mail administratora widoczny w raporcie. Więcej informacji o ciągach zapytania i właściwościach odpowiedzi znajdziesz w przewodniku po interfejsie API. Aby zwiększyć czytelność, przykładowy kod ma taki format:
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
Poniższy przykład przedstawia raport o wszystkich zmianach w aplikacji w konsoli administracyjnej wykonanych przez john@example.com. Odpowiedź jest filtrowana i zwraca wszystkie działania, których OLD_VALUE ma wartość ALLOW_CAMERA. Przykład odpowiedzi API znajdziesz w przykładzie odpowiedzi JSON. Informacje na temat aktywności znajdziesz w nazwach zdarzeń dla administratorów:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Pobierz całą aktywność według nazwy zdarzenia
Aby pobrać raport o wszystkich działaniach związanych z daną nazwą zdarzenia, użyj takiego żądania HTTP GET i uwzględnij token autoryzacji opisany w dokumentacji autoryzacji. Więcej informacji o eventNamenazwach zdarzeń administracyjnych. Więcej informacji o ciągach zapytania i właściwościach odpowiedzi znajdziesz w przewodniku po interfejsie API. Aby zwiększyć czytelność, przykładowy kod ma taki format:
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 powoduje pobranie raportu dla wszystkich wystąpień zmiany nazwy użytkownika w konsoli administracyjnej. Przykład odpowiedzi 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 zdarzeń i administratorów
Aby pobrać raport o wszystkich zmianach w konsoli administracyjnej dotyczących określonego zdarzenia przeprowadzonego przez konkretnego administratora, użyj tego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. userKey to podstawowy adres e-mail administratora widoczny w raporcie. Więcej informacji o eventNamenazwach zdarzeń administracyjnych. Więcej informacji o ciągach zapytania i właściwościach odpowiedzi znajdziesz w przewodniku po interfejsie API. Aby zwiększyć czytelność, przykładowy kod ma taki format:
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 przedstawia raport o wszystkich zmianach w konsoli administracyjnej dotyczących określonego imienia i nazwiska wprowadzonego przez użytkownika john@example.com. Przykład odpowiedzi API znajdziesz w przykładzie 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 w raporcie aktywności administratora
Pomyślna odpowiedź zwraca kod stanu HTTP 200. Razem z kodem stanu odpowiedź zawiera raport. Więcej informacji o eventNamenazwach zdarzeń administracyjnych. Więcej informacji o ciągach zapytań w adresach URL i właściwościach odpowiedzi znajdziesz w przewodniku po interfejsie 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 requestor 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 requestor 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": ""
}
]
}
]
}
]
}