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