Questo documento fornisce una panoramica dell'API Google Drive Activity.
L'API Drive Activity ti consente di eseguire query per gli eventi recenti. Puoi recuperare una cronologia dettagliata di tutte le attività, incluse informazioni granulari su ogni evento. Ciò è utile per attività come gli audit, in quanto puoi recuperare attività precise che includono le informazioni ActionDetail, Actor e Target.
L'API Drive Activity è costituita dalla risorsa
DriveActivity, che rappresenta
le modifiche apportate agli oggetti all'interno di Google Drive di un utente, e dal metodo
activity.query, che consente di recuperare
informazioni su queste modifiche.
Richiesta
La tua app richiede i dati delle attività di un utente utilizzando il metodo activity.query. Puoi richiedere l'attività per un elemento di Drive specifico o per tutto ciò che è contenuto in una cartella di Drive. Per una determinata richiesta, puoi scegliere di limitare la
risposta utilizzando un filtro, ad esempio un intervallo di tempo
o un tipo di azione, e puoi scegliere di consolidare l'attività nella risposta. Per saperne di più,
consulta Effettuare richieste nell'API Google Drive Activity.
Risposta
La risposta contiene un elenco di attività corrispondenti ai parametri specificati, in cui
una risorsa DriveActivity rappresenta ogni
attività:
Una risorsa DriveActivity è una raccolta di oggetti Action, ognuno dei quali è autonomo come un evento. Un Action include un ActionDetail (ad esempio Create o Edit), un Actor (ad esempio User o Administrator), un Target (ad esempio DriveItem o Drive) e un
Timestamp
o un TimeRange.
Una risorsa DriveActivity contiene anche informazioni di riepilogo, come ogni
Actor e Target di tutte le azioni, un Timestamp o TimeRange unificato
e il ActionDetail più importante o rappresentativo del Action.
Per maggiori informazioni, consulta il modello di dati dell'API Drive Activity.
Visibilità della cronologia attività
Alcune attività su Drive potrebbero non essere segnalate quando utilizzi l'API Drive Activity. Se l'API segnala una determinata modifica a un oggetto dipende dal fatto che la modifica o le informazioni sulla modifica siano visibili all'utente autenticato nella tua app.
La visibilità si basa sulle autorizzazioni impostate per l'oggetto. Esistono diversi scenari in cui file e cartelle vengono condivisi su Drive:
Se un autore condivide un documento, la cronologia attività del documento è visibile sia al creatore sia agli utenti con cui è stato condiviso.
Se un documento è stato condiviso con un utente e poi reso privato, l'utente può visualizzare tutta la cronologia delle attività del periodo in cui aveva accesso, ma non dopo che le autorizzazioni sono state limitate.
Se un documento non è mai stato condiviso con un utente, quest'ultimo non può visualizzare alcuna cronologia dell'attività.
Argomenti correlati
- Per ottenere il massimo dall'API Drive Activity, integra prima la tua app con l'API Google Drive.
- Per informazioni sullo sviluppo con le API Google Workspace, inclusa la creazione di un progetto o la gestione dell'autenticazione e dell'autorizzazione, consulta Sviluppare su Google Workspace.
- Per scoprire di più sulle attività, consulta il Riferimento API.