Visão geral de arquivos e pastas

O Google Drive organiza arquivos em coleções, descreve arquivos por tipos e fornece atributos específicos para cada arquivo para facilitar a manipulação de arquivos.

A API Google Drive representa os arquivos armazenados no Drive como um recurso File.

Responsabilidade

O Drive organiza arquivos com base na relação do usuário com o conteúdo e o local de armazenamento dele. 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 de arquivos. Um único usuário é o proprietário dos arquivos no Meu Drive, enquanto um grupo ou 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 hierarquia principal e consiste em tudo que descende dessa pasta raiz. O usuário é o proprietário principal da pasta.
Drives compartilhados
Um drive compartilhado é uma estrutura organizacional no Drive que fica paralela à do Meu Drive. Você pode organizar um arquivo individual em um drive compartilhado ou em "Meu Drive", mas não em ambos. No entanto, os atalhos do Drive podem ser usados para apontar para arquivos ou pastas dos 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 contenha texto ou conteúdo binário, como imagens, vídeos e PDFs.
Pasta

Um contêiner que pode ser usado para organizar outros tipos de arquivo no Drive. As pastas são arquivos que contêm apenas metadados e têm o tipo MIME application/vnd.google-apps.folder.

Observação:um único arquivo armazenado em "Meu Drive" pode estar contido em várias pastas. Um único arquivo armazenado em um drive compartilhado só pode ter uma pasta mãe.

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 com conteúdo vinculado a um sistema de armazenamento de terceiros. O tipo MIME do arquivo de atalho de terceiros é application/vnd.google-apps.drive-sdk. Para ver mais informações, consulte Criar um atalho para um arquivo externo.

Documento do Google Workspace

Um arquivo criado por um aplicativo do Google Workspace, como Documentos, Planilhas ou Apresentações Google. O formato MIME é application/vnd.google-apps.*app*, em que app é o nome do aplicativo (como application/vnd.google-apps.spreadsheet para um arquivo do Planilhas Google). Para ver 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.

Observação:não é possível fazer upload ou download de pastas, atalhos, atalhos de terceiros e documentos do Google Workspace de ou para o Drive. No entanto, se eles usarem formatos compatíveis, será possível fazer upload ou exportar documentos do Google Workspace. Por exemplo, é possível criar um arquivo dos Documentos Google ao importar um PDF. Da mesma forma, você pode exportar um arquivo do Apresentações Google como um arquivo do Microsoft PowerPoint.

Características do arquivo

Esta lista mostra algumas características de um arquivo do Drive:

ID do arquivo
Um ID exclusivo e opaco para cada arquivo. Os IDs de arquivos são estáveis durante a vida útil do arquivo, mesmo que o nome do arquivo seja alterado. As expressões de pesquisa são usadas para localizar arquivos por nome, tipo, conteúdo, contêiner pai, proprietário ou outros metadados.
Metadata
Dados que descrevem o conteúdo do arquivo. Esses dados incluem os nomes, o tipo, a criação e os tempos de modificação. Alguns campos de metadados, como name, são independentes de usuário e aparecem da mesma forma para cada um. Outros campos, como capabilities e viewedByMeDate, contêm valores específicos do usuário. Os tipos de arquivo, como imagens e vídeos, contêm outros metadados extraídos do EXIF e de outros metadados incorporados.
Permissão
Uma concessão de acesso para que um usuário, grupo, domínio ou o mundo acesse uma hierarquia de arquivos ou pastas. Os usuários controlam quem pode acessar um arquivo com a lista de controle de acesso (ACL), que é uma lista de permissões do arquivo. Para mais informações, consulte Compartilhar arquivos, pastas e drives.
Conteúdo
O binário ou o corpo do texto do arquivo. Alguns exemplos de conteúdo que podem ser armazenados no Google Drive são imagens, vídeos, texto e PDF.
Histórico de revisões
O registro de mudanças apenas no conteúdo do arquivo, não nos metadados. 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 miniaturas automaticamente para vários tipos de arquivos comuns. Para atalhos e outros tipos de arquivo que o Drive não pode renderizar, forneça uma imagem em miniatura.

Organização de arquivos

A API Drive organiza arquivos em locais de armazenamento, spaces, e coleções, em 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 apps geralmente armazenam arquivos de configuração e outros dados que não podem ser acessados diretamente pelos usuários.

Não é possível mover arquivos entre os espaços.

Corporação

Coleções de arquivos usados para restringir o escopo das pesquisas de arquivos e pastas. Os corpora para o Google 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 o usuário em "Compartilhados comigo".

  • drive: inclui todos os arquivos contidos em um único drive compartilhado, 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 o corpo allDrives com cuidado, porque ele tem um escopo amplo e pode afetar a performance. Quando possível, use user ou drive em vez de allDrives para aumentar a eficiência.

Os arquivos podem se mover livremente entre corpora quando as permissões e a propriedade mudam.

Próximas etapas

Veja a seguir algumas das próximas etapas: