Per le app di Google Drive che devono tenere traccia delle modifiche agli elementi in Drive, la raccolta Modifiche offre un modo efficiente per rilevare le modifiche. La raccolta funziona fornendo lo stato corrente di ogni elemento, se e solo se l'elemento è cambiato da un determinato momento in poi.
Google Drive mantiene un log delle modifiche per ogni utente e Drive condiviso. Ognuno ha il proprio record delle modifiche agli elementi che lo interessano.
Per monitorare le modifiche di tutti gli elementi visibili a un utente, è necessario riprodurre sia il log delle modifiche dell'utente sia i log delle modifiche di tutti i drive condivisi di cui l'utente è membro.
Attivare le voci di modifica
Una voce di modifica rappresenta lo stato del file o del Drive condiviso in un determinato momento. Una modifica non fornisce un delta tra le revisioni. Le applicazioni che devono sapere quali proprietà sono cambiate devono mantenere costante lo stato noto in precedenza dell'elemento e fare un confronto.
Poiché le modifiche rappresentano lo stato corrente di un elemento, le singole voci di modifica possono essere invalidate e sostituite da una voce di modifica più recente per l'elemento corrispondente.
Tombstone
Le voci di modifica per gli elementi non più disponibili per un utente sono contrassegnate come deleted
nella voce di modifica. Nella voce di modifica è disponibile solo l'ID dell'elemento.
Monitorare i Drive condivisi
Ogni Drive condiviso ha il proprio log delle modifiche. Anche se un utente può essere membro di un Drive condiviso, alcune modifiche vengono applicate solo nel log delle modifiche del Drive condiviso e mai nel log delle modifiche dell'utente. Se un file appartiene a un Drive condiviso, anche se il file è ancora visualizzato nel log delle modifiche dell'utente in un determinato momento nel passato, la riproduzione del solo log delle modifiche dell'utente non aggiornerà correttamente lo stato del file. Devi invece riprodurre il log delle modifiche del Drive condiviso per acquisire tutte le modifiche.
Che cosa è incluso nel log delle modifiche di un utente
Il log delle modifiche di un utente include le modifiche ai Drive condivisi di cui è membro, nonché le modifiche ai file nel corpus dell'utente. Per ulteriori informazioni sui corpora, consulta la Panoramica di modifiche e revisioni.
Queste modifiche al Drive condiviso vengono visualizzate nel log delle modifiche dell'utente:
- L'utente diventa membro di un Drive condiviso.
- L'utente non è più un membro di un Drive condiviso.
- È stata apportata una modifica direttamente pertinente a un Drive condiviso di cui l'utente è membro, ad esempio:
- Il livello di accesso dell'utente sul Drive condiviso è cambiato.
- Il Drive condiviso viene rinominato.
Quando un utente diventa membro di un Drive condiviso, nel log delle modifiche dell'utente viene visualizzato un singolo evento di modifica per il Drive condiviso. Ciò implica accesso a tutti gli elementi del Drive condiviso. L'utente non riceve le modifiche agli elementi contenuti all'interno del Drive condiviso quando diventa membro.
I membri di un Drive condiviso possono vedere gli eventi di modifica degli elementi in un Drive condiviso in base al loro utilizzo. Tuttavia, le applicazioni non devono fare affidamento su questi eventi quando l'utente è un membro del Drive condiviso. Utilizza invece il log delle modifiche del Drive condiviso per monitorare le modifiche.
Se a un non membro viene concesso l'accesso ai file di singoli elementi di un Drive condiviso, le modifiche a questi elementi vengono monitorate nel log delle modifiche dell'utente. È lo stesso per gli elementi di Drive non condivisi che vengono condivisi direttamente con gli utenti.
Modifiche visualizzate nel log delle modifiche di un Drive condiviso
Se un utente è membro di un Drive condiviso, può accedere al log delle modifiche del Drive condiviso, che contiene:
- Eventuali modifiche al Drive condiviso stesso, ad esempio l'aggiunta o la rimozione di un membro
- Modifiche dirette agli elementi contenuti nel Drive condiviso.
Autorizzazioni e funzionalità di sincronizzazione
Le modifiche alle autorizzazioni del Drive condiviso o degli elementi all'interno di un Drive condiviso si riflettono solo sull'elemento stesso. Sebbene tutti gli elementi secondari diretti o indiretti di questo elemento erediteranno questa modifica, non verrà registrata una voce distinta nel log delle modifiche per ciascuno di questi elementi. Per ricostruire completamente le modifiche, i client devono propagare le nuove funzionalità o recuperare nuovamente ogni elemento se un elemento principale è stato modificato.