L'API Google Drive Activity è composta dalla risorsa DriveActivity
, che rappresenta le modifiche apportate agli oggetti all'interno del 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 sull'attività di un utente utilizzando il
metodo activity.query
. Puoi richiedere attività per un elemento specifico di Drive o per tutti i contenuti di una cartella di Drive. Per una determinata richiesta, puoi scegliere di limitare la risposta per vincoli come intervallo di tempo o tipo di azione e puoi scegliere di consolidare l'attività nella risposta. Per saperne di più, vedi Effettuare 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
, ognuno dei quali è
autonomo come un evento. Un Action
include
ActionDetail
(ad esempio Create
o Edit
), Actor
(come User
o Administrator
), Target
(ad esempio DriveItem
o Drive
) e
Timestamp
o TimeRange
.
Una risorsa DriveActivity
contiene anche
informazioni di riepilogo, come ogni
Actor
e
Target
di tutte le azioni, un elemento
Timestamp
o TimeRange
unificato e la più
importante o rappresentativa
ActionDetail
di
Action
.
Per ulteriori informazioni, vedi il modello dei dati dell'API Drive Activity.
Visibilità della cronologia attività
Alcune attività su Drive potrebbero non essere segnalate quando utilizzi questa API. La possibilità che l'API Drive Activity registri una determinata modifica a un oggetto dipende dalla visibilità della modifica o delle informazioni relative alla modifica per l'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 attività relativa al documento è visibile non solo all'autore, ma anche agli utenti autenticati con cui è stato condiviso.
- Se un documento è stato condiviso con un utente e poi reso privato, l'utente autenticato può vedere tutta la cronologia delle attività mentre aveva accesso e che ora le autorizzazioni sono limitate.
- Se un documento non è mai stato condiviso con un utente, quest'ultimo non può vedere alcuna cronologia delle attività.
Inizia
Per ottenere il massimo dall'API Drive Activity, integra innanzitutto 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, scopri di più sulle attività nel riferimento API.