파일 및 폴더 개요

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

Google Drive API는 Drive에 저장된 파일을 File 리소스로 나타냅니다.

책임감

Drive는 사용자와 콘텐츠 간의 관계 및 저장소 위치에 따라 파일을 구성합니다. 컬렉션은 파일 메타데이터의 일부로 지정되며 Drive에 파일이 저장된 파일 그룹을 표시합니다. 내 드라이브와 공유 드라이브 컬렉션의 주요 차이점은 파일 소유권입니다. 단일 사용자는 내 드라이브에 있는 파일의 소유자이고 그룹 또는 조직은 공유 드라이브에 있는 파일을 소유하고 있습니다.

내 드라이브
각 사용자에게는 기본 계층 구조로 작동하는 '내 드라이브'라는 '루트' 폴더가 있으며 이 루트 폴더의 하위 요소로 구성됩니다. 사용자가 이 폴더의 기본 소유자입니다.
공유 드라이브
공유 드라이브는 내 드라이브와 병행되는 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 유형을 참고하세요.

참고: Drive 간에 폴더, 바로가기, 서드 파티 바로가기, Google Workspace 문서를 업로드하거나 다운로드할 수 없습니다. 하지만 호환되는 형식을 사용하는 경우 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를 사용하세요.

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

다음 단계

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