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 sulle 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 in base a vincoli, come l'intervallo di tempo o il tipo di azione, e puoi scegliere di consolidare l'attività nella risposta. Per maggiori informazioni, vedi Effettuare richieste nell'API Drive Activity.
Risposta
La risposta a una richiesta è un elenco di attività che corrispondono 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 un
ActionDetail
(ad esempio Create
o Edit
), un Actor
(come 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 ogni
Actor
e
Target
di tutte le azioni, un valore
Timestamp
o TimeRange
unificato e quello più
importante o rappresentativo
ActionDetail
del
Action
.
Per ulteriori informazioni, consulta 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 segnalazione di una determinata modifica da parte dell'API Drive Activity 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 file e cartelle vengono condivisi in Drive:
- Se un autore condivide un documento, la cronologia delle attività del 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 l'accesso e le autorizzazioni ora sono limitate.
- Se un documento non è mai stato condiviso con un utente, quest'ultimo non potrà visualizzare la cronologia delle 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, puoi approfondire l'argomento e leggere le informazioni sulle attività consultando il riferimento API.