Il report 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 Attività di Drive per ottenere un elenco di tutti i nuovi documenti di Drive creati da un determinato utente in un intervallo di date specificato. Puoi utilizzare queste informazioni per ottenere informazioni su come gestire meglio i contenuti e su possibili fughe di dati. Per ottenere un report, utilizzi la richiesta di 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 fino agli ultimi 180 giorni.
Il report Attività di Google Drive può essere utilizzato solo per scopi legali negli account a cui è stata assegnata una licenza.
Per informazioni sulle stringhe di query della richiesta e sulle proprietà di risposta, consulta il riferimento API. Per informazioni su eventi specifici relativi a Google Drive, consulta Nomi degli eventi di Drive.
Recuperare gli eventi di Google Drive per un dominio
Puoi utilizzare il report Attività di Drive per elencare le 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 copre fino a 180 giorni. Per ottenere questo report, ottieni 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 vedere un esempio di risposta a questa chiamata API.
L'esempio seguente recupera un report di tutti gli eventi di Drive negli 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 sulle 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 o 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 sulle attività di Google Drive per un determinato drive condiviso utilizzando una richiesta HTTP GET con il token di autorizzazione descritto nella guida all'autorizzazione. Specifica l'indirizzo email dell'utente per cui vuoi eseguire il report nel campo userKey oppure all per eseguirlo su tutti gli utenti.
L'esempio seguente recupera un report di tutte le modifiche apportate a 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 dell'abbonamento, 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 o 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 effettui 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 relativa ai 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"
}
]
}
]
},
]
}