Il report sull'attività di Drive fornisce informazioni sui tuoi utenti attività 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 per un determinato intervallo di date. Puoi utilizzare queste informazioni per ottenere approfondimenti una migliore gestione dei contenuti e possibili fughe di dati. Per ottenere un report, utilizzi la richiesta di endpoint del report di base con parametri specifici del report come all'indirizzo email di un utente o a 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 legittimi negli account che Avere una licenza assegnata.
Per informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta, consulta 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 Attività di Drive per elencare le informazioni sul tuo
Documenti di Drive. Ad esempio, puoi richiedere un report che elenca
ai 25 eventi di Drive più recenti del tuo account, che coprono fino a 180
giorni. Per ottenere questo report, ottieni un token di autorizzazione come descritto in
guida all'autorizzazione, poi 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 i file 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 rapporto delle attività di Google Drive di un determinato utente, utilizza un
Richiesta GET HTTP con il token di autorizzazione descritto in
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 da per l'utente specificato. Per un esempio di risposta dell'API, consulta 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 uno specifico
utilizzando una richiesta GET HTTP con il token di autorizzazione descritto
guida all'autorizzazione. Specifica
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 uno specifico alla guida. 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 doc_type. La
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 delle iscrizioni, specifica 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 modifica un documento, utilizza una richiesta GET HTTP con l'autorizzazione
come 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 tutta la creazione della documentazione dell'account attività. 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 effettui una richiesta HTTP GET all'API, una risposta corretta restituisce un
Codice di stato HTTP 200. Insieme al codice di stato, la risposta restituisce un report
per Drive. Questi report sono disponibili anche
Console di amministrazione. Per ulteriori informazioni, consulta
Centro assistenza per amministratori di Google Workspace.
Per informazioni su eventName, consulta
Nomi degli eventi di Drive
riferimento. Per ulteriori informazioni sulle stringhe di query della richiesta e
proprietà di risposta, consulta 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"
}
]
}
]
},
]
}