如果 Google 雲端硬碟應用程式需要追蹤 Google 雲端硬碟中項目的變更,變更集合可提供有效的變更偵測方式。集合會提供每個項目的目前狀態,但只有在項目自指定時間點起有所變更時才會提供。
Google 雲端硬碟會為每位使用者和共用雲端硬碟保留變更記錄。每個使用者都有自己感興趣的項目變更記錄。
如要追蹤使用者可見的「所有」項目變更,請重播使用者變更記錄,以及使用者所屬所有共用雲端硬碟的變更記錄。
啟用變更項目
變更項目代表檔案或共用雲端硬碟在特定時間點的狀態。變更不會提供修訂版本之間的差異。需要瞭解哪些屬性已變更的應用程式,應保留先前已知的項目狀態並進行比較。
由於變更代表項目的目前狀態,因此個別變更項目可能會失效,並由對應項目的較新變更項目取代。
空值標記
使用者無法再使用的項目變更項目會在變更項目中標示為 deleted
。變更項目中只會顯示項目 ID。
追蹤共用雲端硬碟
每個共用雲端硬碟都有專屬的變更記錄。即使使用者是共用雲端硬碟的成員,某些變更只會反映在共用雲端硬碟變更記錄中,絕不會出現在使用者的變更記錄中。如果檔案屬於共用雲端硬碟,即使檔案在過去某個時間點仍會顯示在使用者的變更記錄中,單獨重播使用者的變更記錄也無法正確更新檔案狀態。您必須重播共用雲端硬碟的變更記錄,才能擷取所有變更。
使用者變更記錄包含的內容
使用者的變更記錄包含他們所屬共用雲端硬碟的變更,以及使用者文件集合中的檔案變更。如要進一步瞭解語料庫,請參閱變更和修訂總覽。
以下共用雲端硬碟異動會顯示在使用者的變更記錄中:
- 使用者會成為共用雲端硬碟的成員。
- 使用者不再是共用雲端硬碟的成員。
- 使用者所屬共用雲端硬碟發生直接相關變更,例如:
- 使用者在該共用雲端硬碟上的存取層級已變更。
- 共用雲端硬碟已重新命名。
當使用者成為共用雲端硬碟的成員時,使用者的變更記錄中會顯示共用雲端硬碟的單一變更事件。這表示可存取共用雲端硬碟中的所有項目。使用者成為共用雲端硬碟的成員後,不會收到共用雲端硬碟內項目的變更通知。
共用雲端硬碟的成員可能會根據使用情況,看到共用雲端硬碟中項目的變更事件。不過,如果使用者是共用雲端硬碟的成員,應用程式就不得依賴這些事件。請改用共用雲端硬碟的變更記錄追蹤變更。
如果非成員獲得共用雲端硬碟中個別項目的檔案存取權,系統會在使用者的變更記錄中追蹤這些項目的變更。這與直接與使用者共用的非共用 Drive 項目相同。
共用雲端硬碟變更記錄中顯示的變更
如果使用者是共用雲端硬碟的成員,就能存取該共用雲端硬碟的變更記錄,其中包含:
- 共用雲端硬碟本身的任何變更,例如新增或移除成員
- 直接變更共用雲端硬碟中的項目。
同步權限和功能
共用雲端硬碟或共用雲端硬碟內項目的權限變更,只會反映在項目本身。雖然該項目的所有直接或間接子項都會繼承這項變更,但變更記錄中不會為每個項目建立個別項目。如要完整重建變更,用戶端必須傳播新功能,或重新擷取每個項目,以便重新建構變更。