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