Google Drive는 수정사항의 자동 기록을 유지하므로 사용자가 파일 변경사항과 콘텐츠 수정사항을 추적하는 데 도움이 됩니다. 업데이트 기록에서 사용자는 어떤 수정사항이 적용되었는지 확인하고 특정 수정사항이 적용된 파일의 특정 버전으로 되돌릴 수 있습니다.
다음 용어는 Google Drive API의 변경사항 및 버전 리소스와 관련이 있습니다.
액세스 제어 목록 (ACL)
파일, 폴더 또는 공유 드라이브와 연결된 모든 권한 리소스 목록입니다.
변경
파일 콘텐츠 또는 파일이나 공유 드라이브의 메타데이터에 적용된 변경사항
사용자 변경 로그
사용자가 내 드라이브의 수정 가능한 모든 파일(예: Google Docs, Sheets, Slides)에 적용한 모든 변경사항의 기록입니다. 공유 드라이브의 멤버의 경우 사용자 변경 로그에는 공유 드라이브 멤버십, 해당 공유 드라이브의 항목에 대한 사용자 액세스 수준, 공유 드라이브 이름 변경에 관한 항목도 포함됩니다.
공유 드라이브 변경 로그
사용자 추가 또는 삭제와 같은 공유 드라이브의 모든 변경사항과 해당 공유 드라이브의 항목에 대한 모든 변경사항의 기록입니다. 공유 드라이브 내 항목의 변경사항은 사용자 변경 로그와 공유 드라이브 변경 로그에 모두 표시됩니다.
변경 로그 항목
파일의 콘텐츠 또는 파일이나 공유 드라이브의 메타데이터에 적용된 변경사항의 기록입니다. 변경 로그 항목에는 변경한 사용자, 타임스탬프, ID가 표시됩니다. 변경 로그에는 파일 또는 공유 드라이브당 하나의 항목만 있을 수 있습니다. 파일 또는 공유 드라이브가 변경될 때마다 항목에 새 ID가 생성되고 이전 항목이 대체됩니다.
버전
파일의 콘텐츠 (메타데이터 아님) 변경을 나타내는 파일 버전입니다. 각 수정 버전은 Drive API 내의 revisions 리소스를 사용하여 액세스할 수 있습니다.
헤드 버전
파일의 최신 버전입니다. headRevisionId는 Drive API 내의 files 리소스를 사용하여 액세스할 수 있습니다. headRevisionId은 Drive의 blob 파일에만 사용할 수 있습니다.
Blob 버전
이미지, 동영상 또는 PDF와 같이 수정할 수 없는 바이너리 파일의 버전입니다. 블롭 버전이 바이너리 파일의 유일한 버전인 경우 삭제할 수 없습니다. 새로운 blob은 새로운 버전으로 업로드할 수 있으며, 이 버전은 해당 파일의 새로운 헤드 버전이 됩니다.
헤드 버전을 제외하고 '영구 보관'으로 지정되지 않은 모든 blob 파일 버전은 삭제할 수 있습니다. 삭제 가능한 버전은 일반적으로 30일 동안 보관되지만, 파일에 '영구 보관'으로 지정되지 않은 버전이 100개 있고 새 버전이 업로드되면 더 일찍 삭제될 수 있습니다.
파일의 모든 수정사항을 시간순으로 기록한 것입니다. Docs, Sheets, Slides 파일이 변경되면 새 버전이 생성됩니다. 콘텐츠가 변경될 때마다 Drive에서 해당 파일의 새 버전 기록 항목을 만듭니다. 하지만 이러한 편집기 파일 버전은 병합될 수 있으므로 API 응답에 파일의 모든 변경사항이 표시되지 않을 수 있습니다.
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[],[],null,["# Changes and revisions overview\n\nGoogle Drive maintains an automatic history of modifications, which can help\nusers track file changes and content revisions. In the revision history, users\ncan see what edits have been made and can revert to a specific version of a file\nwith specific edits.\n\nThe following terms are relevant to the changes and revisions resources of the\nGoogle Drive API:\n\n*Access Control List (ACL)*\n: The list of all permission resources associated with a file, folder, or shared\n drive.\n\n*Change*\n: An alteration made to a file's content or metadata of a file or shared drive.\n\n*User change log*\n\n: A record of all changes that a user made to every editable file in their My\n Drive, such as a Google Docs, Sheets, or a\n Slides. For members of a shared drive, the user change log\n also includes entries about shared drive membership, user access levels to\n items in that shared drive, and shared drive name changes.\n\n | **Note:** Even if several users can access the same file, not all changes to that file are reflected in every users' change log. For example, when a user opens the file for the first time, or marks the file as Starred, those changes only appear in that users' change log. As another example, when a file's ACL is changed, it's only reflected in the change log of the following users: The file's owner, any service accounts on the ACL, and any users directly impacted by the ACL change.\n\n*Shared drive change log*\n\n: A record of all changes to a shared drive, such as additions or removals of\n users, and all changes to items on that shared drive. A change to an item\n within a shared drive appears in both the *user change log* and shared drive\n change log.\n\n*Change log entry*\n\n: A record of a change made to a file's content or metadata of a file or shared\n drive. A change log entry indicates the user who made the change, the\n timestamp, and an ID. There can only be one entry per file or shared drive\n in the change log at a time. Each time that file or shared drive changes, a\n new ID is created for that entry, and it replaces the previous entry.\n\n*Revision*\n\n: A version of the file representing a change to the file's contents (not\n metadata). Each revision can be accessed using the [`revisions`](/workspace/drive/api/reference/rest/v3/revisions) resource within the Drive API.\n\n*Head revision*\n\n: The most current version of a file. The `headRevisionId` can be accessed using\n the [`files`](/workspace/drive/api/reference/rest/v3/files) resource within the\n Drive API. The `headRevisionId` is only available for blob files\n in Drive.\n\n*Blob revision*\n\n: A version of an unmodifiable binary file, such as an image, video, or PDF. If\n the blob revision is the only revision of the binary file, it cannot be\n deleted. A new blob can be uploaded as a new *revision* , which becomes the\n new *head revision* of that file.\n\n Any blob file revision, other than the head revision, that's not designated\n as \"Keep Forever\" is purgeable. Purgeable revisions are typically preserved\n for 30 days, but can be purged earlier if a file has 100 revisions that\n aren't designated as \"Keep Forever\" and a new revision is uploaded.\n\n For more information on setting blob revisions as \"Keep Forever\", see\n [Specify revisions to save from auto\n delete](/workspace/drive/api/guides/manage-revisions#specify-revisions).\n\n*Revision history*\n\n: A record of all revisions of a file in chronological order. A change to a\n Docs, Sheets, or Slides file\n gets a new revision. Each time the content changes, Drive\n creates a new revision history entry for that file. However, these editor\n file revisions may be merged together, so the API response might not show\n all changes to a file.\n\nRelated topics\n--------------\n\n- To identify where the change you want to track is recorded, see [Identify\n which change log to track](/workspace/drive/api/guides/about-changelogs).\n- To set up change tracking for users and shared drives, see [Track changes\n for users and shared drives](/workspace/drive/api/guides/about-changes).\n- To download a blob file content revision or to export a Google Workspace document content revision, see [Download and export\n files](/workspace/drive/api/guides/manage-downloads).\n- To publish a revision, see [Manage file\n revisions](/workspace/drive/api/guides/manage-revisions).\n- To set up change notifications, see [Notifications for resource changes](/workspace/drive/api/guides/push)."]]
