Raport aktywności administratora

Raport aktywności administratora zawiera informacje o działaniach wszystkich administratorów Twojego konta w konsoli administracyjnej. Każdy raport korzysta z podstawowego żądania punktu końcowego raportu z parametrami związanymi z raportem, takimi jak nazwa administratora czy konkretne zdarzenie w konsoli administracyjnej. Maksymalny przedział czasowy każdego raportu to 180 dni.

Raport aktywności administratora może być używany wyłącznie do celów zgodnych z prawem zgodnie z Umową klienta. Te raporty dotyczą kont Google Workspace, Education oraz Dostawców Usług Internetowych.

Pobierz wszystkie działania administracyjne

Aby pobrać raport o wszystkich działaniach administracyjnych na koncie, użyj poniższego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. Więcej informacji o ciągach zapytań żądania i właściwościach odpowiedzi znajdziesz w dokumentacji interfejsu API. Aby zapewnić czytelność, poniższy przykład jest sformatowany ze zwrotami 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 raport o wszystkich czynnościach administracyjnych na koncie w ciągu ostatnich 180 dni. Jest to maksymalny okres objęty raportem. Z kolei ciąg zapytania maxResults wskazuje, że raport zawiera 2 zdarzenia na każdej stronie raportu. Przykład odpowiedzi interfejsu 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 z ostatnich 180 dni. customerId określa klienta, dla którego ma zostać pobrany raport.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?customerId=C03az79cb

Pobierz całą aktywność administratora

Aby pobrać raport o wszystkich działaniach w konsoli administracyjnej wykonanych przez określonego administratora, użyj poniższego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. userKey to podstawowy adres e-mail administratora uwzględnionego w raporcie. Więcej informacji o ciągach zapytań żądania i właściwościach odpowiedzi znajdziesz w dokumentacji interfejsu API. Aby zapewnić czytelność, poniższy przykład jest sformatowany ze zwrotami 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

Poniższy przykład pokazuje raport o wszystkich zmianach w aplikacji konsoli administracyjnej wprowadzonych przez użytkownika john@example.com. Odpowiedź jest filtrowana tak, aby zwracała wszystkie aktywności, których OLD_VALUE to ALLOW_CAMERA. Przykład odpowiedzi interfejsu API znajdziesz w przykładzie odpowiedzi JSON. Informacje o tych działaniach znajdziesz w nazwach zdarzeń administratora:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA

Pobierz wszystkie aktywności według nazwy wydarzenia

Aby pobrać raport o wszystkich aktywnościach związanych z konkretną nazwą zdarzenia, użyj poniższego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. Informacje dotyczące eventName znajdziesz w informacjach referencyjnych dotyczących nazw zdarzeń administratora. Więcej informacji o ciągach zapytań żądania i właściwościach odpowiedzi znajdziesz w dokumentacji interfejsu API. Aby zapewnić czytelność, poniższy przykład jest sformatowany ze zwrotami 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

W poniższym przykładzie pobrano raport na temat wszystkich wystąpień zmiany nazwiska użytkownika w konsoli administracyjnej. Przykład odpowiedzi 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

Pobierz całą aktywność według wydarzenia lub administratora

Aby pobrać raport o wszystkich zmianach nazwy zdarzenia w konsoli administracyjnej wprowadzonych przez określonego administratora, użyj poniższego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. userKey to podstawowy adres e-mail administratora uwzględnionego w raporcie. Informacje dotyczące eventName znajdziesz w informacjach referencyjnych dotyczących nazw zdarzeń administratora. Więcej informacji o ciągach zapytań żądania i właściwościach odpowiedzi znajdziesz w dokumentacji interfejsu API. Aby zapewnić czytelność, poniższy przykład jest sformatowany ze zwrotami 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 umożliwia pobranie raportu zawierającego wszystkie zmiany w konsoli administracyjnej wprowadzone przez użytkownika john@example.com. Przykład odpowiedzi interfejsu 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 dotycząca raportu aktywności administratora

Pomyślna odpowiedź zwraca kod stanu HTTP 200. Wraz z kodem stanu odpowiedź zwraca raport. Informacje dotyczące eventName znajdziesz w informacjach referencyjnych dotyczących nazw zdarzeń administratora. Więcej informacji o ciągach zapytania w adresie URL żądania i właściwościach odpowiedzi znajdziesz w dokumentacji interfejsu 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": ""
       }
      ]
     }
    ]
   }
  ]
 }