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