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 determinato intervallo di date. Puoi usare queste informazioni per ottenere insight su una migliore gestione dei contenuti e su possibili fughe di dati. Per ottenere un report, utilizza la richiesta di endpoint del report di base con parametri specifici del report, come 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 sull'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 la documentazione di 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 con un elenco dei 25 eventi di Drive più recenti del tuo account, per un massimo di 180 giorni. Per ottenere questo report, ottieni un token di autorizzazione come descritto nella guida all'autorizzazione, quindi utilizza la seguente richiesta GET HTTP:
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 in base all'utente
Per recuperare un report sulle attività di Google Drive di un determinato utente, utilizza una richiesta GET HTTP con il token di autorizzazione descritto nella guida della guida alle autorizzazioni.
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, vedi 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 relative a un Drive condiviso specifico utilizzando una richiesta GET HTTP con il token di autorizzazione descritto nella guida alle autorizzazioni. Specifica l'indirizzo email dell'utente per il quale vuoi eseguire il report nel campo userKey oppure specifica all per eseguire il report su 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, vedi 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 per un Drive condiviso, filtra utilizzando l'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 per le modifiche all'appartenenza, specifica l'evento shared_drive_membership_change. L'esempio seguente recupera tutti i membri aggiunti 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 GET HTTP 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, vedi 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 GET HTTP all'API, una risposta riuscita restituisce un codice di stato HTTP 200. Insieme 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 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 la documentazione di 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"
}
]
}
]
},
]
}