Drive의 항목 변경사항을 추적해야 하는 Google Drive 앱의 경우 변경사항 수집을 사용하면 변경사항을 효율적으로 감지할 수 있습니다. 컬렉션은 특정 시점 이후에 항목이 변경된 경우에만 각 항목의 현재 상태를 제공하여 작동합니다.
Google Drive는 사용자 및 공유 드라이브별로 변경 로그를 보관합니다. 각 앱에는 관심 있는 항목의 변경사항에 관한 자체 레코드가 있습니다.
사용자에게 표시되는 모든 항목의 변경사항을 추적하려면 사용자 변경 로그와 사용자가 구성원인 모든 공유 드라이브의 변경 로그를 모두 재생해야 합니다.
변경 항목 사용 설정
변경 항목은 특정 시점의 파일 또는 공유 드라이브의 상태를 나타냅니다. 변경사항은 버전 간의 델타를 제공하지 않습니다. 변경된 속성을 알아야 하는 애플리케이션은 이전에 알려진 항목의 상태를 유지하고 비교해야 합니다.
변경사항은 항목의 현재 상태를 나타내므로 개별 변경 항목이 무효화되고 해당 항목의 최신 변경 항목으로 대체될 수 있습니다.
Tombstone
더 이상 사용자가 사용할 수 없는 항목의 변경 항목은 변경 항목에서 deleted로 표시됩니다. 변경 항목에서 항목의 ID만 사용할 수 있습니다.
공유 드라이브 추적
공유 드라이브마다 자체 변경 로그가 있습니다. 사용자가 공유 드라이브의 멤버이더라도 특정 변경사항은 공유 드라이브 변경 로그에만 반영되고 사용자의 변경 로그에는 반영되지 않습니다. 파일이 공유 드라이브에 속하는 경우, 이전에 파일이 사용자의 변경 로그에 계속 표시되었더라도 사용자의 변경 로그만 재생해도 파일 상태가 올바르게 업데이트되지 않습니다. 대신 공유 드라이브의 변경 로그를 재생하여 모든 변경사항을 캡처해야 합니다.
사용자의 변경 로그에 포함되는 항목
사용자의 변경 로그에는 사용자가 멤버인 공유 드라이브의 변경사항과 사용자의 자료에 있는 파일의 변경사항이 포함됩니다. 자료에 관한 자세한 내용은 변경사항 및 버전 개요를 참고하세요.
다음과 같은 공유 드라이브 변경사항이 사용자의 변경 로그에 표시됩니다.
- 사용자가 공유 드라이브의 멤버가 됩니다.
- 사용자가 더 이상 공유 드라이브의 구성원이 아닙니다.
- 사용자가 멤버인 공유 드라이브에 직접 관련된 변경사항이 있습니다. 예를 들면 다음과 같습니다.
- 해당 공유 드라이브에서 사용자의 액세스 수준이 변경되었습니다.
- 공유 드라이브의 이름이 변경됩니다.
사용자가 공유 드라이브의 멤버가 되면 공유 드라이브의 단일 변경 이벤트가 사용자의 변경 로그에 표시됩니다. 이는 공유 드라이브의 모든 항목에 대한 액세스를 의미합니다. 사용자가 공유 드라이브의 멤버가 되어도 공유 드라이브에 포함된 항목의 변경사항은 수신되지 않습니다.
공유 드라이브의 구성원은 사용량에 따라 공유 드라이브의 항목에 대한 변경 이벤트를 볼 수 있습니다. 그러나 사용자가 공유 드라이브의 멤버인 경우 애플리케이션은 이러한 이벤트에 의존해서는 안 됩니다. 대신 공유 드라이브의 변경 로그를 사용하여 변경사항을 추적하세요.
비회원에게 공유 드라이브의 개별 항목에 대한 파일 액세스 권한이 부여된 경우 해당 항목의 변경사항은 사용자의 변경 로그에서 추적됩니다. 이는 사용자와 직접 공유되는 비공유 Drive 항목과 동일합니다.
공유 드라이브 변경 로그에 표시되는 변경사항
사용자가 공유 드라이브의 멤버인 경우 다음이 포함된 공유 드라이브의 변경 로그에 액세스할 수 있습니다.
- 멤버 추가 또는 삭제와 같은 공유 드라이브 자체의 변경사항
- 공유 드라이브에 포함된 항목을 직접 변경합니다.
권한 및 기능 동기화
공유 드라이브 또는 공유 드라이브 내 항목의 권한 변경사항은 항목 자체에만 반영됩니다. 해당 항목의 모든 직접 또는 간접 하위 요소는 이 변경사항을 상속받지만 변경 로그에는 각 항목에 관한 별도의 항목이 없습니다. 클라이언트는 변경사항을 완전히 재구성하려면 새 기능을 전파하거나 상위 요소가 변경된 경우 각 항목을 다시 가져와야 합니다.