L'API Google Drive Activity è costituita 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 l'attività
per un elemento specifico di Drive o per tutto ciò che è contenuto in una cartella
di Drive. Per una determinata richiesta, puoi scegliere di limitare la risposta in base a
vincoli come intervallo di tempo o tipo di azione e puoi
scegliere di consolidare l'attività nella
risposta. Per ulteriori informazioni, consulta Effettuare richieste nell'API Drive Activity.
Risposta
La risposta a una richiesta è un elenco di attività corrispondenti ai parametri specificati,
in cui 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 (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 il ActionDetail
più importante o rappresentativo
del Action.
Per saperne di più, consulta il modello di dati dell'API Drive Activity.
Visibilità della cronologia attività
Alcune attività su Drive potrebbero non essere segnalate quando utilizzi questa API. Se l'API Drive Activity segnala 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 file e cartelle vengono condivisi in Drive:
- Se un autore condivide un documento, la cronologia delle attività è visibile non solo al creator, 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ò visualizzare tutta la cronologia attività durante il periodo in cui aveva accesso e che ora le autorizzazioni sono limitate.
- Se un documento non è mai stato condiviso con un utente, quest'ultimo non può visualizzare alcuna cronologia dell'attività.
Inizia
Per sfruttare al meglio l'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 leggere informazioni sulle attività nei riferimenti API.