Questo documento fornisce una panoramica dell'API Google Drive Activity.
L'API Drive Activity consente di eseguire query per gli eventi recenti. Puoi recuperare una cronologia dettagliata di tutte le attività, incluse informazioni granulari su ogni evento. Questa funzionalità è 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
DriveActivity risorsa, che rappresenta
le modifiche apportate agli oggetti all'interno di Google Drive di un utente, e dal
activity.query metodo, che consente di recuperare
informazioni su queste modifiche.
Richiesta
La tua app richiede i dati delle attività di un utente utilizzando il activity.query metodo. 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 ulteriori informazioni,
consulta Effettuare richieste nell'API Google Drive Activity.
Risposta
La risposta contiene un elenco di attività che corrispondono ai parametri specificati, dove
una DriveActivity risorsa rappresenta ogni
attività:
Una risorsa DriveActivity è una raccolta di
Action oggetti, 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 l'ActionDetail più importante o rappresentativo del Action.
Per ulteriori 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. La segnalazione di una determinata modifica a un oggetto da parte dell'API 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 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, l'utente non può visualizzare la cronologia attività.
Argomenti correlati
- Per sfruttare al meglio l'API Drive Activity, integra prima la tua app con l'API Google Drive
- Per scoprire di più 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.