파일 및 폴더 개요

Google Drive는 파일을 컬렉션으로 정리하고 형식별로 파일을 설명하며 파일 조작을 용이하게 하기 위해 각 파일의 특정 속성을 제공합니다.

Google Drive API는 Drive에 저장된 파일을 File 리소스로 표시합니다.

소유권

Drive는 콘텐츠와 스토리지 위치와 사용자의 관계를 기반으로 파일을 구성합니다. 컬렉션은 파일 메타데이터의 일부로 지정되므로 파일이 드라이브 내에 어떤 파일 그룹과 함께 저장되어 있는지 표시됩니다. 내 드라이브와 공유 드라이브 컬렉션의 주요 차이점은 파일 소유권입니다. 단일 사용자는 내 드라이브에 있는 파일의 소유자이고, 그룹 또는 조직은 공유 드라이브의 파일을 소유합니다.

내 드라이브
각 사용자에게는 기본 계층 구조로 작동하는 '내 드라이브'라는 '루트' 폴더가 있으며 이 루트 폴더의 모든 하위 요소로 구성됩니다. 사용자가 이 폴더의 기본 소유자입니다.
공유 드라이브
공유 드라이브는 드라이브 내에서 내 드라이브와 동시에 실행되는 조직 구조입니다. 공유 드라이브 또는 내 드라이브 내에서 개별 파일을 정리할 수 있지만 둘 다 구성할 수는 없습니다. 하지만 Drive 단축키를 사용하여 공유 드라이브에서 내 드라이브로 파일 또는 폴더를 가리킬 수 있으며 그 반대의 경우도 마찬가지입니다.

파일 형식

Drive에서는 파일을 유형별로 설명합니다. 이 목록에는 사용 가능한 모든 파일 형식이 표시됩니다.

Blob
텍스트 또는 바이너리 콘텐츠(예: 이미지, 동영상, PDF)가 포함된 파일입니다.
폴더

Drive에 있는 다른 유형의 파일을 정리하는 데 사용할 수 있는 컨테이너 폴더는 메타데이터만 포함하고 MIME 유형 application/vnd.google-apps.folder를 갖는 파일입니다.

참고: 내 드라이브에 저장된 단일 파일이 여러 폴더에 포함될 수 있습니다. 공유 드라이브에 저장된 단일 파일에는 상위 폴더가 하나만 있을 수 있습니다.

단축키

Drive의 다른 파일을 가리키는 메타데이터 전용 파일입니다. 바로가기 파일 MIME 유형은 application/vnd.google-apps.shortcut입니다. 자세한 내용은 Drive 파일의 바로가기 만들기를 참고하세요.

서드 파티 바로가기

타사 저장소 시스템에 저장된 콘텐츠로 연결되는 메타데이터 전용 파일입니다. 서드 파티 바로가기 파일 MIME 유형은 application/vnd.google-apps.drive-sdk입니다. 자세한 내용은 외부 파일 바로가기 만들기를 참고하세요.

Google Workspace 문서

Google Workspace 애플리케이션에서 생성하는 파일입니다(예: Google Docs, Sheets, Slides). MIME 유형 형식은 application/vnd.google-apps.*app*이며, 여기서 app은 애플리케이션 이름입니다(예: Google Sheets 파일의 경우 application/vnd.google-apps.spreadsheet). Drive 및 Google Workspace 관련 MIME 유형의 목록은 Google Workspace 및 Google Drive에서 지원되는 MIME 유형을 참고하세요.

참고: 폴더, 바로가기, 서드 파티 바로가기, Google Workspace 문서를 Drive 간에 업로드하거나 다운로드할 수 없습니다. 하지만 호환되는 형식을 사용하면 Google Workspace 문서를 업로드하거나 내보낼 수 있습니다. 예를 들어 PDF를 가져올 때 Google 문서를 만들 수 있습니다. 마찬가지로 Google Slides 프레젠테이션을 Microsoft PowerPoint 파일로 내보낼 수 있습니다.

파일 특성

다음 목록은 Drive 파일의 몇 가지 특성을 보여줍니다.

파일 ID
각 파일의 고유한 불투명 ID입니다. 파일 ID는 파일 이름이 바뀌더라도 파일의 수명 기간 내내 안정적입니다. 검색 표현식은 이름, 유형, 콘텐츠, 상위 컨테이너, 소유자 또는 기타 메타데이터별로 파일을 찾는 데 사용됩니다.
메타데이터
파일의 콘텐츠를 설명하는 데이터입니다. 이 데이터에는 이름, 유형, 생성 및 수정 시간이 포함됩니다. name와 같은 일부 메타데이터 필드는 사용자에 구애받지 않으며 각 사용자에게 동일하게 표시됩니다. capabilities 및 viewedByMeDate와 같은 다른 필드에는 사용자별 값이 포함됩니다. 이미지 및 동영상과 같은 파일 형식에는 EXIF 및 삽입된 기타 메타데이터에서 추출한 추가 메타데이터가 포함됩니다.
권한
파일이나 폴더 계층 구조에 액세스하기 위한 사용자, 그룹, 도메인 또는 전 세계의 액세스 권한입니다. 사용자는 파일에 대한 권한 목록인 액세스제어 목록 (ACL)을 사용하여 파일에 액세스할 수 있는 사용자를 제어합니다. 자세한 내용은 파일, 폴더, 드라이브 공유를 참고하세요.
콘텐츠
파일의 바이너리 또는 텍스트 본문입니다. Google Drive에 저장할 수 있는 콘텐츠의 예로는 이미지, 동영상, 텍스트, PDF가 있습니다.
업데이트 기록
파일 메타데이터가 아닌 파일 콘텐츠만의 변경 기록입니다. 버전에 대한 자세한 내용은 변경사항 및 버전 개요를 참고하세요.
썸네일
파일을 그래픽으로 표현한 것입니다. Drive는 여러 일반적인 파일 형식의 썸네일을 자동으로 생성합니다. Drive에서 렌더링할 수 없는 바로가기 및 기타 파일 형식의 경우 썸네일 이미지를 제공할 수 있습니다.

파일 구성

Drive API는 파일을 spaces라는 스토리지 위치와 corpora라는 컬렉션으로 구성합니다.

가상 설치

서로 격리된 특정 저장소 위치 Drive의 모든 콘텐츠는 정의된 두 공간(drive 및 appDataFolder) 중 하나에 저장됩니다.

  • drive: Drive에서 생성된 사용자에게 표시되는 모든 파일을 포함합니다. 사용자가 업로드하는 PDF, 문서, Google Docs, 바로가기, 기타 콘텐츠는 drive 공간에 있습니다.

  • appDataFolder: 사용자별 애플리케이션 데이터를 포함합니다. 애플리케이션은 일반적으로 사용자가 직접 액세스할 수 없는 구성 파일과 기타 데이터를 저장합니다.

스페이스 간에 파일을 이동할 수 없습니다.

코르포라

파일 및 폴더 검색 범위를 좁히는 데 사용되는 파일 컬렉션 Drive의 코퍼스는 user, domain, drive, allDrives입니다.

  • user: '내 드라이브'에서 사용자가 만들고 연 모든 파일과 '공유 문서함'에서 사용자와 직접 공유한 파일이 포함됩니다.

  • drive: driveId에 표시된 대로 단일 공유 드라이브에 포함된 모든 파일을 포함합니다.

  • domain: 사용자의 도메인과 공유된 검색 가능한 모든 파일을 포함합니다.

  • allDrives: 사용자가 멤버인 공유 드라이브의 모든 파일과 '내 드라이브' 및 '공유 문서함'의 모든 파일을 포함합니다. allDrives 코퍼스는 범위가 넓고 성능에 영향을 줄 수 있으므로 주의해서 사용하세요. 가능하면 효율성을 위해 allDrives 대신 user 또는 drive를 사용하세요.

권한과 소유권이 변경됨에 따라 파일이 코퍼스 간에 자유롭게 이동할 수 있습니다.

다음 단계

그 다음으로는 아래와 같은 옵션도 고려해 볼 수 있습니다.