L'API Google Drive Activity è composta 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 attività
per un elemento specifico di Drive o per tutti gli elementi contenuti in una
cartella di Drive. Per una determinata richiesta, puoi scegliere di limitare la risposta in base a limitazioni come intervallo di tempo o tipo di azione e puoi scegliere di consolidare l'attività nella risposta. Per ulteriori informazioni, consulta Eseguire richieste nell'API Drive Activity.
Risposta
La risposta a una richiesta è un elenco di attività corrispondenti ai parametri specificati,
dove una
risorsa DriveActivity rappresenta ogni attività:
Una risorsa DriveActivity è una raccolta di oggetti
Action, ciascuno indipendente 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 TimeRange.
Una risorsa DriveActivity contiene anche informazioni di riepilogo, ad esempio tutti i Actor e Target di tutte le azioni, un Timestamp o TimeRange unificato e il 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 registrate quando utilizzi questa API. Il fatto che l'API Drive Activity registri una determinata modifica a un oggetto dipende dal fatto che la modifica o le informazioni sulla modifica siano visibili all'utente autenticato nella tua applicazione.
La visibilità si basa sulle autorizzazioni impostate per l'oggetto. Esistono diversi scenari in cui i file e le cartelle vengono condivisi in Drive:
- Se un autore condivide un documento, la cronologia delle attività del documento è visibile non solo al creator, ma anche agli utenti autenticati con cui è stato condiviso.
- Se un documento è stato condiviso con un utente e poi è stato reso privato, l'utente autenticato può vedere tutta la cronologia delle attività mentre aveva accesso e che le autorizzazioni ora sono limitate.
- Se un documento non è mai stato condiviso con un utente, quest'ultimo non può vedere alcuna cronologia attività.
Inizia
Per ottenere il massimo dall'API Drive Activity, integra prima la tua app con l'API Google Drive. Per iniziare a utilizzare l'API Drive Activity, scopri come creare un progetto e autorizzare le richieste. In alternativa, inizia subito a leggere sulle attività nel riferimento all'API.