Il report sulle attività degli amministratori ti fornisce informazioni sulle attività della Console di amministrazione di tutti gli amministratori del tuo account. Ogni report utilizza la richiesta di base dell'endpoint del report con parametri specifici, come il nome di un amministratore o un determinato evento della Console di amministrazione. Il periodo di tempo massimo per ogni report corrisponde agli ultimi 180 giorni.
Il report sull'attività degli amministratori può essere utilizzato solo per scopi legali 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 eseguite per un account, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione descritto nella documentazione relativa all'autorizzazione. Per ulteriori informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta la documentazione di riferimento API. Per favorire la leggibilità, il formato del seguente esempio è costituito da 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 mostra un report su tutte le attività amministrative del tuo account negli ultimi 180 giorni, che rappresenta 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 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 per gli ultimi 180 giorni. L'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. userKey è l'indirizzo email principale dell'amministratore nel report. Per ulteriori informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta la documentazione di riferimento API. Per favorire la leggibilità, il formato del seguente esempio è costituito da 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 restituisce un report su tutte le modifiche apportate all'applicazione Console di amministrazione eseguite da john@example.com e la risposta viene filtrata in modo da restituire tutte le attività con un valore di OLD_VALUE uguale a ALLOW_CAMERA. Per un esempio di risposta dell'API, vedi l'esempio di risposta JSON. Per informazioni sulle attività, consulta 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 di evento specifico, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione descritto nella documentazione relativa all'autorizzazione. Per informazioni su eventName, consulta le informazioni di riferimento sui nomi degli eventi amministratore. Per ulteriori informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta la documentazione di riferimento API. Per favorire la leggibilità, il formato del seguente esempio è costituito da 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 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 determinato nome evento effettuato da un determinato amministratore, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione descritto nella documentazione relativa all'autorizzazione. userKey è l'indirizzo email principale dell'amministratore nel report. Per informazioni su eventName, consulta le informazioni di riferimento sui nomi degli eventi amministratore. Per ulteriori informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta la documentazione di riferimento API. Per favorire la leggibilità, il formato del seguente esempio è costituito da 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 apportate nella Console di amministrazione al cognome di un utente specifico apportate da john@example.com. Per un esempio di risposta dell'API, vedi 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 nel 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 amministratore. Per ulteriori informazioni sulle stringhe di query dell'URL della richiesta e sulle proprietà della risposta, consulta la documentazione di riferimento per le 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": ""
}
]
}
]
}
]
}