Introduzione all'API Google Drive Activity

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à:

Spiegazione dell'attività in Drive.

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.