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 ti consente di recuperare le informazioni sulle modifiche.
Risorse richieste:
La tua app richiede i dati sulle attività di un utente utilizzando il metodo activity.query. Puoi richiedere l'attività per un elemento di Drive specifico o per tutti i contenuti di una cartella di Drive. Per una determinata richiesta, puoi scegliere di limitare la risposta in base ai vincoli, ad esempio l'intervallo di tempo o il tipo di azione, e puoi decidere di mantenere l'attività consolidata 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 ciascuna attività:
Una risorsa DriveActivity è una raccolta di oggetti Action, ognuno dei quali è indipendente come un evento. Un Action include un
ActionDetail (come Create
o Edit), un Actor (come User
o Administrator), un Target (come
14/} 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'opzione Timestamp unificata o TimeRange e la più importante o rappresentativa ActionDetail di Action.
Per saperne di più, vedi il modello dei dati dell'API Drive Activity.
Visibilità cronologia attività
Alcune attività su Drive potrebbero non essere segnalate quando utilizzi questa API. Il fatto che l'API Drive Activity segnali una determinata modifica in un oggetto dipende dal fatto che la modifica o dalle informazioni che contiene vengano mostrate all'utente autenticato nell'applicazione.
La visibilità si basa sulle autorizzazioni impostate per l'oggetto. Quando file e cartelle vengono condivisi su Drive, esistono diversi scenari:
- Se un autore condivide un documento, la cronologia attività del documento sarà visibile non solo all'autore, ma anche agli utenti autenticati con cui è stato condiviso.
- Se un documento è stato condiviso con un utente e poi è stato impostato come privato, l'utente autenticato può vedere tutta la cronologia attività mentre disponeva dell'accesso e che le autorizzazioni sono ora limitate.
- Se un documento non è mai stato condiviso con un utente, quest'ultimo non può visualizzare la cronologia attività.
Inizia
Per ottenere il massimo dall'API Drive Activity, integra prima l'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, esplora direttamente le attività nel riferimento API.