Introduzione all'API Google Drive Activity

L'API Google Drive Activity è composta da DriveActivity, che rappresenta le modifiche apportate agli oggetti all'interno del Google Drive di un utente e activity.query, che ti consente di recuperare le informazioni relative a tali modifiche.

Richiesta

La tua app richiede i dati sull'attività di un utente utilizzando activity.query. Puoi richiedere attività per un elemento specifico di Drive o per tutto ciò che è contenuto in un Drive . Per una determinata richiesta, puoi scegliere di limitare la risposta per vincoli come l'intervallo di tempo o il tipo di azione può scegliere di consolidare l'attività nel 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 un La risorsa DriveActivity rappresenta ogni attività:

Spiegazione dell'attività di Drive.

Una risorsa DriveActivity è una raccolta Action oggetti, ognuno dei quali indipendente come un evento. Un Action include un ActionDetail (ad esempio Create o Edit), un Actor (ad esempio User o Administrator), un Target (ad esempio come DriveItem o Drive) e un Timestamp o TimeRange.

Una risorsa DriveActivity contiene anche informazioni di riepilogo, come Actor e Target tra tutte le azioni, un'istanza Timestamp o TimeRange e la versione importante o rappresentativo ActionDetail dei 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. Indica se L'API Drive Activity segnala che una determinata modifica a un oggetto dipende dal fatto che la modifica o le relative informazioni sono visibili all'utente autenticato utente nella tua applicazione.

La visibilità si basa sulle autorizzazioni impostate per l'oggetto. Ci sono diverse scenari in cui i file e le cartelle sono condivisi in Drive:

  • Se un autore condivide un documento, la cronologia delle attività per quel documento è visibile non solo all'autore, ma anche agli utenti autenticati con chi è stato condiviso.
  • Se un documento è stato condiviso con un utente e poi reso privato, l'utente può vedere tutta la cronologia attività mentre aveva accesso e che ora le autorizzazioni sono limitato.
  • Se un documento non è mai stato condiviso con un utente, quest'ultimo non potrà vedere nessuna attività storia.

Inizia

Per ottenere il massimo dall'API Drive Activity, integra la tua app con API Google Drive. Per iniziare a utilizzare l'API Drive Activity, scopri come creare un progetto delle richieste di autorizzazione. Oppure, inizia subito a leggere sulle attività del Riferimento API.