Per le app Google Drive che devono tenere traccia delle modifiche apportate agli elementi in Drive, la raccolta Changes offre un modo efficiente per rilevare le modifiche. La raccolta funziona fornendo lo stato attuale di ogni elemento, se e solo se l'elemento è cambiato da un determinato momento in poi.
Google Drive conserva un log delle modifiche per ogni utente e Drive condiviso. Ognuno ha il proprio registro delle modifiche agli elementi di interesse.
Per monitorare le modifiche per 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.
Abilitare 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 conservare lo stato precedentemente noto dell'elemento e confrontarlo.
Poiché le modifiche rappresentano lo stato attuale di un elemento, le singole voci di modifica possono essere invalidate e sostituite con una voce di modifica più recente per l'elemento corrispondente.
Tombstones
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 è membro di un Drive condiviso, alcune modifiche vengono visualizzate 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 presente nel log delle modifiche dell'utente in un determinato momento del 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.
Cosa è incluso nel log delle modifiche di un utente
Il log delle modifiche di un utente include anche le modifiche ai Drive condivisi di cui fa parte e le modifiche ai file nel corpus dell'utente. Per ulteriori informazioni sui corpora, vedi 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ù 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 al Drive condiviso è stato modificato.
- 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 l'accesso a tutti gli elementi del Drive condiviso. L'utente non riceve le modifiche agli elementi contenuti nel Drive condiviso quando ne diventa membro.
I membri di un Drive condiviso potrebbero visualizzare 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 è 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 singoli elementi di un Drive condiviso, le modifiche apportate a questi elementi vengono monitorate nel log delle modifiche dell'utente. È lo stesso degli 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 relativo log delle modifiche, che contiene:
- Qualsiasi modifica apportata al Drive condiviso stesso, ad esempio l'aggiunta o la rimozione di un membro
- Modifiche dirette agli elementi contenuti nel Drive condiviso.
Sincronizzazione di autorizzazioni e funzionalità
Le modifiche alle autorizzazioni del Drive condiviso o degli elementi al suo interno vengono riflesse solo sull'elemento stesso. Sebbene tutti gli elementi secondari diretti o indiretti di questo elemento ereditino questa modifica, non verrà creata una voce separata nel log delle modifiche per ciascuno di questi elementi. I client devono propagare le nuove funzionalità o recuperare nuovamente ogni elemento se un elemento principale è cambiato per ricostruire completamente le modifiche.