파일 및 폴더 개요

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

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

소유권

Drive는 사용자와 콘텐츠의 관계 및 저장소 위치를 기반으로 파일을 정리합니다. 컬렉션은 파일이 Drive 내에 저장된 파일 그룹을 표시하기 위해 파일의 메타데이터의 일부로 지정됩니다. 내 드라이브와 공유 드라이브 컬렉션의 주요 차이점은 파일 소유권입니다. 내 드라이브의 파일은 단일 사용자가 소유하지만 공유 드라이브의 파일은 그룹 또는 조직에서 소유합니다.

내 드라이브
각 사용자에게는 기본 계층 구조 역할을 하는 '내 드라이브'라는 '루트' 폴더가 있으며 이 루트 폴더에서 파생된 모든 항목으로 구성됩니다. 사용자가 이 폴더의 기본 소유자입니다.
공유 드라이브
공유 드라이브는 내 Drive와 동시에 존재하는 Drive 내의 조직 구조입니다. 공유 드라이브 또는 내 드라이브 내에서 개별 파일을 정리할 수 있지만 둘 다를 동시에 정리할 수는 없습니다. 하지만 드라이브 바로가기를 사용하면 공유 드라이브의 파일 또는 폴더를 내 드라이브로, 또는 그 반대로 연결할 수 있습니다.

파일 형식

Drive는 파일을 유형별로 설명합니다. 다음 목록에는 사용 가능한 모든 파일 형식이 나와 있습니다.

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

Drive에서 다른 유형의 파일을 정리하는 데 사용할 수 있는 컨테이너입니다. 폴더는 메타데이터만 포함하고 MIME 유형이 application/vnd.google-apps.folder인 파일입니다. 자세한 내용은 폴더 만들기 및 채우기를 참고하세요.

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

Google Workspace 문서

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

단축키

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

서드 파티 바로가기

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

파일 특성

다음 목록에는 Drive 파일의 몇 가지 특성이 나와 있습니다.

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

파일 구성

Drive API는 파일을 spaces라고 하는 저장소 위치와 corpora라고 하는 컬렉션으로 구성합니다.

스페이스

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

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

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

파일은 spaces 간에 이동할 수 없습니다.

Corpora

파일 및 폴더 검색 범위를 좁히는 데 사용되는 파일 모음입니다. Drive의 자료는 user, domain, drive, allDrives입니다.

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

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

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

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

권한 및 소유권이 변경되면 파일이 corpora 간에 자유롭게 이동할 수 있습니다.

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