Il report sull'attività di Drive fornisce informazioni sulle attività degli utenti quando gestiscono, modificano e condividono file su Google Drive in Google Workspace. Ad esempio, puoi utilizzare il report sull'attività di Drive per ottenere un elenco di tutti i nuovi documenti di Drive creati da un determinato utente in un intervallo di date specifico. Puoi utilizzare queste informazioni per ottenere approfondimenti su una migliore gestione dei contenuti e possibili perdite di dati. Per ottenere un report, utilizza la richiesta dell'endpoint del report di base con parametri specifici del report, ad esempio l'indirizzo email di un utente o un tipo specifico di modifica di Google Drive. I report possono includere i dati degli ultimi 180 giorni.
Il report attività di Google Drive può essere utilizzato solo per scopi leciti negli account a cui è stata assegnata una licenza.
Per informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta il Riferimento API. Per informazioni su eventi specifici relativi a Google Drive, vedi Nomi degli eventi di Drive.
Recuperare gli eventi di Google Drive per un dominio
Puoi utilizzare il report sull'attività di Drive per elencare informazioni sui tuoi documenti di Drive. Ad esempio, puoi richiedere un report che elenca
i 25 eventi di Drive più recenti del tuo account, che coprono fino a 180
giorni. Per ottenere questo report, richiedi un token di autorizzazione come descritto nella
guida all'autorizzazione, quindi utilizza
la seguente richiesta HTTP GET:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Puoi visualizzare un'esempio di risposta a questa chiamata API.
L'esempio seguente recupera un report di tutti gli eventi di Drive degli ultimi 180 giorni, il periodo massimo.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Recuperare gli eventi di Google Drive per utente
Per recuperare un report delle attività di Google Drive di un determinato utente, utilizza una
richiesta HTTP GET con il token di autorizzazione descritto nella
guida all'autorizzazione.
Il campo userKey è l'indirizzo email principale dell'utente nel report oppure
all per tutti gli utenti.
L'esempio seguente recupera un report che elenca tutte le modifiche apportate dall'utente specificato. Per un esempio di risposta dell'API, consulta la risposta JSON di esempio.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
Recuperare gli eventi di Google Drive per i Drive condivisi
Puoi recuperare un report delle attività di Google Drive per un drive condiviso specifico utilizzando una richiesta HTTP GET con il token di autorizzazione descritto nella guida all'autorizzazione. Specifica l'indirizzo email dell'utente per cui vuoi generare il report nel campo userKey oppure specifica all per generare il report per tutti gli utenti.
L'esempio seguente recupera un report di tutte le modifiche per un Drive condiviso specifico. Per un esempio di risposta dell'API, consulta la risposta JSON di esempio.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
Per recuperare gli eventi di un Drive condiviso, filtra utilizzando doc_type. L'esempio
seguente recupera gli eventi che interessano tutti i Drive condivisi:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
Per recuperare gli eventi relativi alle modifiche all'iscrizione, specifica l'evento shared_drive_membership_change. L'esempio seguente recupera tutte le aggiunte di membri ai Drive condivisi:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
Recuperare gli eventi di Google Drive per tipo di evento
Per recuperare un report di tutte le istanze di un tipo di evento specifico, ad esempio la creazione
o la modifica di un documento, utilizza una richiesta HTTP GET con il token di autorizzazione
descritto nella guida all'autorizzazione.
Il campo userKey è l'indirizzo email principale dell'utente nel report oppure
all per tutti gli utenti.
L'esempio seguente recupera un report di tutte le attività di creazione della documentazione dell'account. Per un esempio di risposta dell'API, consulta la risposta JSON di esempio:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
Esempio di risposta JSON
Quando invii una richiesta HTTP GET all'API, una risposta riuscita restituisce un codice di stato HTTP 200. Oltre al codice di stato, la risposta restituisce un report
per Drive. Questi report sono disponibili anche nella Console di amministrazione. Per ulteriori informazioni, consulta il
Centro assistenza per gli amministratori di Google Workspace.
Per informazioni su eventName, consulta la
documentazione di riferimento sui
nomi degli eventi di Drive. Per ulteriori informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta il Riferimento API.
{
"kind": "reports#auditActivities",
"nextPageToken": "next page's token",
"items": [
{
"kind": "audit#activity",
"id": {
"time": "2014-03-17T15:39:18.460Z",
"uniqQualifier": "report's unique ID",
"applicationName": "drive",
"customerId": "ABC123xyz"
},
"actor": {
"callerType": "USER",
"email": "kim@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in an OAuth 2LO request"
},
"ownerDomain": "domain of the source owner",
"ipAddress": "user's IP address",
"events": [
{
"type": "access",
"name": "edit",
"parameters": [
{
"name": "primary_event",
"boolValue": true
},
{
"name": "owner_is_shared_drive",
"boolValue": false
}, {
"name": "doc_id",
"value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
},
{
"name": "doc_title",
"value": "Meeting notes"
},
{
"name": "doc_type",
"value": "document"
},
{
"name": "owner",
"value": "mary@example.com"
}
]
}
]
},
]
}