Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Google Drive organiza os arquivos em coleções, descreve os arquivos por tipos e fornece atributos específicos para cada um deles, facilitando a manipulação.
A API Google Drive representa arquivos armazenados no Drive como um recurso
files.
Propriedade
O Drive organiza os arquivos com base na relação do usuário com o conteúdo e no local de armazenamento. As coleções são especificadas como parte dos
metadados do arquivo para mostrar com qual grupo de arquivos ele está armazenado no
Drive. A principal diferença entre o "Meu Drive" e as coleções de drives compartilhados é a propriedade dos arquivos. Um único usuário é o proprietário dos arquivos no Meu Drive, enquanto um grupo ou uma organização é o proprietário dos arquivos em um drive compartilhado.
Meu Drive
Cada usuário tem uma pasta "raiz" chamada "Meu
Drive", que funciona como a hierarquia principal e
consiste em tudo que deriva dessa pasta raiz. O usuário é o
proprietário principal desta pasta.
Drives compartilhados
Um drive compartilhado é uma estrutura organizacional no Drive que fica paralela ao Meu Drive. É possível organizar um arquivo individual em um drive compartilhado ou no Meu Drive, mas não nos dois. No entanto, os
atalhos do Drive podem ser usados para
apontar para arquivos ou pastas de drives compartilhados para o Meu Drive ou
vice-versa.
Tipos de arquivo
O Drive descreve os arquivos por tipos. Esta lista mostra todos os tipos de arquivo disponíveis:
Blob
Um arquivo que contém texto ou conteúdo binário, como imagens, vídeos e PDFs.
Pasta
Um contêiner que você pode usar para organizar outros tipos de arquivos no Drive. As pastas são arquivos que contêm apenas metadados e têm
o tipo MIME application/vnd.google-apps.folder. Para mais informações, consulte Criar e preencher pastas.
Observação:um único arquivo armazenado em Meu Drive pode estar em várias pastas. Um único arquivo armazenado em um drive compartilhado só pode ter uma pasta principal.
Documento do Google Workspace
Um arquivo criado por um aplicativo do Google Workspace, como Documentos, Planilhas ou Apresentações Google. O formato do tipo MIME é
application/vnd.google-apps.*app*, em que app é o nome do aplicativo
(como application/vnd.google-apps.spreadsheet para um
arquivo do Planilhas). Para uma lista de tipos MIME específicos do Drive e do Google Workspace, consulte Tipos MIME compatíveis com o Google Workspace e o Google Drive.
Atalho
Um arquivo somente de metadados que aponta para outro arquivo no Drive. O tipo MIME do arquivo de
atalho é application/vnd.google-apps.shortcut. Para mais
informações, consulte Criar um atalho para um arquivo do
Drive.
Atalho de terceiros
Um arquivo somente de metadados que se vincula a conteúdo armazenado em um sistema de armazenamento de terceiros. O tipo MIME do arquivo de atalho de terceiros é
application/vnd.google-apps.drive-sdk. Para mais informações, consulte Criar um
arquivo de atalho para o conteúdo armazenado pelo
app.
Características do arquivo
Esta lista mostra algumas características de um arquivo do Drive:
O corpo binário ou de texto do arquivo. Alguns exemplos de conteúdo que você pode armazenar no
Drive são imagens, vídeos, texto e PDFs.
ID do arquivo
Um ID exclusivo e opaco para cada arquivo. Os IDs de arquivo são estáveis durante toda a vida útil do arquivo, mesmo que o nome mude. Expressões de pesquisa são usadas para localizar arquivos por nome, tipo, conteúdo, contêiner principal, proprietário ou outros metadados.
Metadados
Dados que descrevem o conteúdo do arquivo. Esses dados incluem o nome, o tipo e os horários de criação e modificação. Alguns campos de metadados, como name, são independentes do usuário e aparecem da mesma forma para todos. Outros campos, como capabilities e viewedByMeDate, contêm valores específicos do usuário. Tipos de arquivo, como imagens e vídeos, contêm metadados adicionais extraídos de EXIF e outros metadados incorporados. Para mais informações, consulte Gerenciar metadados de
arquivos.
Permissão
Uma concessão de acesso para um usuário, grupo, domínio ou o mundo acessar um arquivo ou uma hierarquia de pastas. Os usuários controlam quem pode acessar um arquivo com a lista de controle de acesso (ACL), que é uma lista de permissões para o arquivo. Para mais
informações, consulte Compartilhar arquivos, pastas e
unidades.
Histórico de revisões
O registro de mudanças no conteúdo do arquivo apenas, não nos metadados dele. Para
mais detalhes sobre revisões, consulte Visão geral de mudanças e revisões.
Miniatura
Uma representação gráfica de um arquivo. O Drive gera automaticamente miniaturas para muitos tipos de arquivos comuns. Para atalhos e outros
tipos de arquivos que o Drive não consegue renderizar, você pode fornecer uma
imagem em miniatura. Para mais informações, consulte Fazer upload de miniaturas.
Organização de arquivos
A API Drive organiza os arquivos em locais de armazenamento, chamados de spaces, e coleções, chamadas de corpora.
Espaços
Locais de armazenamento específicos que são isolados uns dos outros. Todo o conteúdo do
Drive é armazenado em um destes dois espaços definidos: drive
e appDataFolder.
drive: inclui todos os arquivos visíveis ao usuário criados no
Drive. PDFs, documentos, Documentos Google, atalhos e
outros conteúdos enviados pelo usuário ficam no espaço drive.
appDataFolder: inclui dados de aplicativos por usuário. Os aplicativos
normalmente armazenam arquivos de configuração e outros dados que não devem ser
acessados diretamente pelos usuários.
Não é possível mover arquivos entre spaces.
Corpora
Coleções de arquivos usadas para restringir o escopo das pesquisas de arquivos e pastas. Os
corpora do Drive são: user, domain, drive e
allDrives.
user: inclui todos os arquivos criados e abertos pelo usuário em "Meu Drive" e aqueles compartilhados diretamente com ele em "Compartilhados comigo".
drive: inclui todos os arquivos contidos em uma única unidade compartilhada, conforme indicado pelo driveId.
domain: inclui todos os arquivos pesquisáveis compartilhados com o domínio do usuário.
allDrives: inclui todos os arquivos nos drives compartilhados em que o usuário é membro e todos os arquivos em "Meu Drive" e "Compartilhados comigo".
Use os corpus allDrives com cautela, já que eles têm um escopo amplo e podem afetar a performance. Quando possível, use user ou drive em vez de allDrives para aumentar a eficiência.
Os arquivos podem ser movidos livremente entre corpora à medida que as permissões e a propriedade mudam.
[null,null,["Última atualização 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."]]
