Visão geral de arquivos e pastas

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:

Proposta de acesso
Uma proposta de um solicitante para um aprovador conceder a um destinatário acesso a um item do Drive. Para mais informações, consulte Listar e resolver propostas de acesso pendentes.
Conteúdo
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.

Veja a seguir algumas das próximas etapas: