Il report sull'attività amministrativa restituisce informazioni sulle attività della Console di amministrazione di tutti gli amministratori del tuo account. Ogni report utilizza la richiesta di endpoint di base con parametri specifici del report, ad esempio il nome di un amministratore o un evento specifico della Console di amministrazione. Il periodo di tempo massimo per ogni report è gli ultimi 180 giorni.
Il report sull'attività amministrativa può essere utilizzato solo per scopi leciti in conformità al Contratto con il cliente. Questi report si applicano agli account Google Workspace, Education e ISP.
Recuperare tutte le attività amministrative
Per recuperare un report di tutte le attività amministrative eseguite per un account,
utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione
descritto nella documentazione
sull'autorizzazione. Per ulteriori informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta il riferimento API.
Per favorire la leggibilità, il seguente esempio è formattato con ritorni a capo:
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
L'esempio seguente recupera un report su tutte le attività amministrative
del tuo account negli ultimi 180 giorni, ovvero il periodo di tempo massimo per un report.
La stringa di query maxResults determina che questo report contiene due
eventi per pagina del report. Per un esempio di risposta dell'API, consulta
l'esempio di risposta JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
L'esempio seguente recupera un report su tutte le attività amministrative di un cliente negli ultimi 180 giorni. customerId specifica per quale cliente deve essere recuperato il report.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
Recupera tutte le attività per amministratore
Per recuperare un report di tutte le attività della Console di amministrazione eseguite da
un amministratore specifico, utilizza la seguente richiesta HTTP GET e
includi il token di autorizzazione descritto nella
documentazione relativa all'autorizzazione. L'userKey è l'indirizzo email principale dell'amministratore nel report. Per ulteriori informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta il Riferimento API.
Per favorire la leggibilità, il seguente esempio è formattato con ritorni a capo:
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
L'esempio seguente recupera un report su tutte le modifiche all'applicazione
Console di amministrazione apportate da john@example.com e la risposta viene filtrata per restituire tutte le attività che hanno un
OLD_VALUE uguale a ALLOW_CAMERA. Per un esempio di
risposta API, consulta l'esempio di risposta JSON.
Per informazioni sulle attività, vedi i nomi degli eventi
dell'amministratore:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Recuperare tutte le attività in base al nome dell'evento
Per recuperare un report di tutte le attività per un nome evento specifico, utilizza la
seguente richiesta HTTP GET e includi il token di autorizzazione
descritto nella
documentazione sull'autorizzazione. Per le informazioni su eventName, consulta le
informazioni di riferimento sui nomi degli eventi
dell'amministratore. Per ulteriori informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta il Riferimento API.
Per favorire la leggibilità, il seguente esempio è formattato con ritorni a capo:
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
Il seguente esempio recupera un report per tutte le istanze della Console di amministrazione in cui viene modificato il cognome di un utente. Per un esempio di risposta dell'API, consulta l'esempio di risposta JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Recuperare tutte le attività per evento e amministratore
Per recuperare un report di tutte le modifiche alla Console di amministrazione per un
nome evento specifico eseguite da un amministratore specifico, utilizza la seguente
richiesta HTTP GET e includi il token di autorizzazione descritto nella
documentazione relativa all'autorizzazione. L'userKey è l'indirizzo email principale dell'amministratore nel report. Per le informazioni su eventName, consulta le
informazioni di riferimento sui nomi degli eventi
dell'amministratore. Per ulteriori informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta il Riferimento API.
Per favorire la leggibilità, il seguente esempio è formattato con ritorni a capo:
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
Il seguente esempio recupera un report per tutte le modifiche alla Console di amministrazione
apportate al cognome di un utente specifico da
john@example.com. Per un esempio di risposta dell'API, consulta
l'esempio di risposta JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Esempio di risposta JSON del report sulle attività della Console di amministrazione
Una risposta riuscita restituisce un
codice di stato HTTP 200.
Oltre al codice di stato, la risposta restituisce un report. Per le informazioni su eventName, consulta le informazioni di riferimento sui nomi degli eventi per gli amministratori. Per saperne di più sulle stringhe di query dell'URL della richiesta e sulle proprietà della risposta, consulta il Riferimento 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": "" } ] } ] } ] }