Content in Drive is organized in various collections based on the user's relationship with the content as well as it's storage location.
My Drive
Each user has a "root" folder. The user's "My Drive" is their primary hierarchy, and consists of everything which is descended from this root folder.
Shared with me
The "Shared with me" category includes files owned and shared by others users which have been either: directly shared with the current user, a group containing the current user, or have been accessed by the current user.
Team Drives
A Team Drive is a type of organizational structure within Google Drive that lives parallel to My Drive. An individual file may be organized within a Team Drive or My Drive, but not both.
Spaces and corpora
In addition to per-user organizational structures, there are two additional organizational concepts used in the API. These are spaces and corpora.
Spaces
Spaces are isolated storage spaces. Currently there are 3 defined spaces
in Drive: drive
, appDataFolder
, and photos
.
- The default
drive
space includes all user-visible files created or stored in Google Drive. PDFs, Google Docs, Sheets, and slides, as well as any other content the user uploads is located in thedrive
space. - The
appDataFolder
space is a separate storage area for per-user application data. Applications typically store configuration files and other data not intended to be directly accessed by users. - (DEPRECATED) The
photos
space includes all images and videos uploaded to Google Photos.
Files can not move between spaces.
Corpora
Corpora, like spaces, represent different collections of items and are used to direct searches. Unlike spaces, they're not isolated storage. Files within a space may move freely from one corpus to another.
The corpora in the Drive API are:
- The
user
corpus includes all files in "My Drive" and "Shared with me" - The
domain
corpus includes all files shared to the user's domain that are searchable. - The
teamDrive
corpus includes all files contained in a single Team Drive. - The
allTeamDrives
corpus includes all files in Team Drives that the user is a member of. Use of theallTeamDrives
corpus is discouraged for efficiency reasons. Only valid when used with theuser
corpus.
Files can move between corpora as permissions and ownership change.