Collections

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 the drive 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.
  • 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 the allTeamDrives corpus is discouraged for efficiency reasons. Only valid when used with the user corpus.

Files can move between corpora as permissions and ownership change.

发送以下问题的反馈:

此网页
Drive REST API
Drive REST API