Drive는 콘텐츠와의 사용자 관계 및 저장 위치를 기반으로 파일을 정리합니다. 컬렉션은 파일이 Drive 내에 저장된 파일 그룹을 표시하기 위해 파일의 메타데이터의 일부로 지정됩니다. 내 드라이브와 공유 드라이브 컬렉션의 주요 차이점은 파일 소유권입니다. 내 드라이브의 파일은 단일 사용자가 소유하는 반면 공유 드라이브의 파일은 그룹 또는 조직이 소유합니다.
내 드라이브
각 사용자에게는 기본 계층 구조로 작동하고 이 루트 폴더에서 파생된 모든 항목으로 구성된 '내 드라이브'라는 '루트' 폴더가 있습니다. 사용자가 이 폴더의 기본 소유자입니다.
공유 드라이브
공유 드라이브는 Drive 내의 조직 구조로, 내 드라이브와 나란히 있습니다. 공유 드라이브 또는 내 드라이브 내에서 개별 파일을 정리할 수 있지만 둘 다는 안 됩니다. 하지만
드라이브 바로가기를 사용하여 공유 드라이브에서 내 드라이브로 또는 그 반대로 파일이나 폴더를 가리킬 수 있습니다.
파일 형식
Drive는 유형별로 파일을 설명합니다. 다음은 사용 가능한 모든 파일 형식을 보여주는 목록입니다.
Blob
이미지, 동영상, PDF와 같은 텍스트 또는 바이너리 콘텐츠가 포함된 파일
폴더
Drive에서 다른 유형의 파일을 정리하는 데 사용할 수 있는 컨테이너입니다. 폴더는 메타데이터만 포함하고 MIME 유형이 application/vnd.google-apps.folder인 파일입니다. 자세한 내용은 폴더 만들기 및 채우기를 참고하세요.
참고: 내 드라이브에 저장된 단일 파일은 여러 폴더에 있을 수 있습니다. 공유 드라이브에 저장된 단일 파일에는 상위 폴더가 하나만 있을 수 있습니다.
Google Workspace 문서
Google Docs, Sheets, Slides와 같은 Google Workspace 애플리케이션에서 생성하는 파일입니다. 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입니다. 자세한 내용은 앱에서 저장한 콘텐츠로 연결되는 바로가기 파일 만들기를 참고하세요.
파일의 바이너리 또는 텍스트 본문입니다. 드라이브에 저장할 수 있는 콘텐츠의 예로는 이미지, 동영상, 텍스트, 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 간에 이동할 수 없습니다.
코퍼라
파일 및 폴더 검색 범위를 좁히는 데 사용되는 파일 모음입니다. Drive의 코퍼스는 user, domain, drive, allDrives입니다.
user: 사용자가 '내 드라이브'에서 만들고 연 모든 파일과 '공유 문서함'에서 사용자와 직접 공유된 파일을 포함합니다.
drive: driveId에 표시된 대로 단일 공유 드라이브에 포함된 모든 파일을 포함합니다.
domain: 사용자의 도메인과 공유된 검색 가능한 모든 파일을 포함합니다.
allDrives: 사용자가 구성원인 공유 드라이브의 모든 파일과 '내 드라이브' 및 '공유 문서함'의 모든 파일을 포함합니다.
allDrives 코퍼스는 범위가 넓어 실적에 영향을 줄 수 있으므로 주의해서 사용하세요. 가능하면 효율성을 위해 allDrives 대신 user 또는 drive를 사용합니다.
[null,null,["최종 업데이트: 2025-08-04(UTC)"],[],[],null,["# Files and folders overview\n\nGoogle Drive organizes files in collections, describes files by types, and\nprovides specific attributes for each file to facilitate file manipulation.\n\nThe Google Drive API represents files stored on Drive as a\n[`files`](/workspace/drive/api/reference/rest/v3/files) resource.\n| **Note:** Folders are treated as a type of file. For more details about folders, see [File types](#types).\n\nOwnership\n---------\n\nDrive organizes files based on the user's relationship with the\ncontent and its storage location. *Collections* are specified as part of the\nfile's metadata to show which group of files the file is stored with inside\nDrive. The main difference between My Drive and\nshared drive collections is file ownership. A single user is the owner of files\nin their My Drive, whereas a group or organization owns files in\na shared drive.\n\n*My Drive*\n: Each user has a \"root\" folder called \"My\n Drive\" that functions as their primary hierarchy, and\n consists of everything that descends from this root folder. The user is the\n primary owner of this folder.\n\n*Shared drives*\n: A [shared drive](/workspace/drive/api/guides/about-shareddrives) is an\n organizational structure within Drive that lives parallel to\n My Drive. You can organize an individual file within a shared\n drive or My Drive, but not both. However, [Drive shortcuts](/workspace/drive/api/guides/shortcuts) can be used to\n point to files or folders from shared drives to My Drive, or\n the other way around.\n\nFile types\n----------\n\nDrive describes files by types. This list shows all available\nfile types:\n\n*Blob*\n: A file that contains text or binary content such as images, videos, and\n PDFs.\n\n*Folder*\n\n: A container you can use to organize other types of files on\n Drive. Folders are files that only contain metadata, and have\n the MIME type `application/vnd.google-apps.folder`. For more information,\n see [Create and populate folders](/workspace/drive/api/guides/folder).\n\n **Note:** A single file stored on My Drive can be in multiple\n folders. A single file stored on a [shared\n drive](/workspace/drive/api/guides/about-shareddrives) can only have one parent folder.\n\n*Google Workspace document*\n\n: A file that a Google Workspace application\n creates, such as Google Docs, Sheets, or\n Slides. The MIME type format is\n `application/vnd.google-apps.*app*` where *app* is the application name\n (such as `application/vnd.google-apps.spreadsheet` for a\n Sheets file). For a list of Drive and\n Google Workspace-specific MIME types, see [Google Workspace and\n Google Drive supported MIME types](/workspace/drive/api/guides/mime-types).\n\n*Shortcut*\n\n: A metadata-only file that points to another file on Drive. The\n shortcut file MIME type is `application/vnd.google-apps.shortcut`. For more\n information, see [Create a shortcut to a Drive\n file](/workspace/drive/api/guides/shortcuts).\n\n*Third-party shortcut*\n\n: A metadata-only file that links to content stored on a third-party storage\n system. The third-party shortcut file MIME type is\n `application/vnd.google-apps.drive-sdk`. For more information, see [Create a\n shortcut file to content stored by your\n app](/workspace/drive/api/guides/third-party-shortcuts).\n\n| **Note:** You cannot upload or download folders, Google Workspace documents, shortcuts, and third-party shortcuts to or from Drive. However, if they use compatible formats you can upload or export Google Workspace documents. For example, you can create a Docs document when you import a PDF. Similarly, you can export a Google Slides presentation as a Microsoft PowerPoint file.\n\nFile characteristics\n--------------------\n\nThis list shows some characteristics of a Drive file:\n\n*Access proposal*\n: A proposal from a requester to an approver to grant a recipient access to a\n Drive item. For more information, see [List and resolve\n pending access\n proposals](/workspace/drive/api/guides/manage-sharing#access-proposals).\n\n*Content*\n: The binary or text body of the file. Some content examples you can store in\n Drive are images, videos, text, and PDFs.\n\n*File ID*\n: A unique, opaque ID for each file. File IDs are stable throughout the life of\n the file, even if the file name changes. [Search\n expressions](/workspace/drive/api/guides/search-files) are used to locate files by name,\n type, content, parent container, owner, or other metadata.\n\n*Metadata*\n: Data describing the contents of the file. This data includes the name, type,\n creation, and modification times. Some metadata fields, such as the `name`,\n are user-agnostic and appear the same for each user. Other fields, such as\n `capabilities` and `viewedByMeDate` contain user-specific values. File\n types, such as images and videos, contain additional metadata extracted from\n EXIF and other embedded metadata. For more information, see [Manage file\n metadata](/workspace/drive/api/guides/file).\n\n*Permission*\n: An access grant for a user, group, domain, or the world to access a file or a\n folder hierarchy. Users control who can access a file with the access\n control list (ACL), which is a list of permissions for the file. For more\n information, see [Share files, folders and\n drives](/workspace/drive/api/guides/manage-sharing).\n\n*Revision history*\n: The record of changes to the file content only, not the file metadata. For\n more details about revisions, see [Changes and revisions overview](/workspace/drive/api/guides/change-overview).\n\n*Thumbnail*\n: A graphical representation of a file. Drive automatically\n generates thumbnails for many common file types. For shortcuts and other\n file types that Drive can't render, you can provide a\n thumbnail image. For more information, see [Upload thumbnails](/workspace/drive/api/guides/file#upload-thumbnails).\n\nFile organization\n-----------------\n\nThe Drive API organizes files into storage locations, called `spaces`,\nand collections, called `corpora`.\n\n*Spaces*\n\n: Specific storage locations that are isolated from each other. All content in\n Drive is stored in one of these two defined spaces: `drive`\n and `appDataFolder`.\n\n - `drive`: Includes all user-visible files created in\n Drive. PDFs, documents, Google Docs, shortcuts, and\n other content the user uploads is located in the `drive` space.\n\n - `appDataFolder`: Includes per-user application data. Applications\n typically store configuration files and other data not intended to be\n directly accessible by users.\n\n Files cannot move between `spaces`.\n\n*Corpora*\n\n: Collections of files used to narrow the scope of file and folder searches. The\n corpora for Drive are: `user`, `domain`, `drive`, and\n `allDrives`.\n\n - `user`: Includes all files created by and opened by the user in \"My\n Drive\", and those shared directly with the user in\n \"Shared with me.\"\n\n - `drive`: Includes all files contained in a single shared drive, as\n indicated by the `driveId`.\n\n - `domain`: Includes all searchable files shared with the user's domain.\n\n - `allDrives`: Includes all files in shared drives where the user is a\n member, and all files in \"My Drive\" and \"Shared with me.\"\n Use the `allDrives` corpora with caution as it has a broad scope and can\n affect performance. When possible, use `user` or `drive` instead of\n `allDrives` for efficiency.\n\n Files can move freely between `corpora` as permissions and ownership change.\n\nRelated topics\n--------------\n\nHere are a few next steps you might take:\n\n- Learn how to [Create and manage files](/workspace/drive/api/guides/create-file).\n- Learn how to [Create and populate folders](/workspace/drive/api/guides/folder).\n- Learn how to [Upload file data](/workspace/drive/api/guides/manage-uploads).\n- Learn how to [Download and export files](/workspace/drive/api/guides/manage-downloads).\n- Learn how to [Store application-specific data](/workspace/drive/api/guides/appdata).\n- Learn how to [Display the Google Picker](/workspace/drive/api/guides/picker) on a page."]]
