O Google Drive organiza arquivos em coleções, os descreve por tipo e oferece atributos específicos para cada arquivo para facilitar a manipulação.
A API Google Drive representa arquivos armazenados no Drive como um recurso
files
.
Propriedade
O Google Drive organiza arquivos com base na relação do usuário com o do conteúdo e do local de armazenamento. As coleções são especificadas como parte dos metadados do arquivo para mostrar em qual grupo de arquivos o arquivo está armazenado no Drive. A principal diferença entre "Meu Drive" e "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 organização é proprietário dos arquivos em um drive compartilhado.
- Meu Drive
- Cada usuário tem uma "raiz" chamada "Meu Google Drive" que funciona como sua hierarquia principal, e consiste em todos os que decendem dessa pasta raiz. O usuário é o proprietário principal dessa pasta.
- Um drive compartilhado é uma estrutura organizacional no Drive paralela à Meu Drive. Você pode organizar um arquivo específico em uma pasta Drive ou Meu Drive, mas não ambos. No entanto, os atalhos do Drive podem ser usados para apontar arquivos ou pastas de drives compartilhados para o Meu Drive ou vice-versa.
Tipos de arquivo
O Drive descreve os arquivos por tipo. Esta lista mostra todos os tipos de arquivo:
- Blob
- Um arquivo que contém 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 arquivos Google Drive. As pastas são arquivos que contêm apenas metadados 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 pai.
- 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 (comoapplication/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 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 vincula 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 por seu app.
Características do arquivo
Esta lista mostra algumas características de um arquivo do Drive:
- Acessar proposta
- Uma proposta de um solicitante a um aprovador para conceder a um destinatário acesso a uma Item do Google Drive. Para mais informações, consulte Listar e resolver acesso pendente propostas.
- Conteúdo
- O corpo binário ou de texto do arquivo. Alguns exemplos de conteúdo que você pode armazenar em Drive são imagens, vídeos, texto e PDFs.
- ID do arquivo
- Um ID exclusivo e opaco para cada arquivo. Os IDs de arquivo permanecem estáveis durante toda a vida útil o arquivo, mesmo se o nome do arquivo for 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.
- Metadados
- Dados que descrevem o conteúdo do arquivo. Esses dados incluem o nome, o tipo, a criação e os horários de modificação. Alguns campos de metadados, como
name
, são independentes do usuário e aparecem da mesma forma para cada usuário. Outros campos, comocapabilities
eviewedByMeDate
contêm valores específicos do usuário. Tipos de arquivo, como imagens e vídeos, contêm metadados adicionais extraídos do EXIF e outros metadados incorporados. Para mais informações, consulte Gerenciar arquivo metadados. - Permissão
- Uma concessão de acesso para um usuário, grupo, domínio ou qualquer outro usuário acessar um arquivo ou 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 mais informações, consulte Compartilhar arquivos, pastas e unidades de disco.
- 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 muitos tipos de arquivos comuns. Para atalhos e outros tipos de arquivo que o Drive não consegue renderizar, você pode fornecer um imagem em miniatura. Para mais informações, consulte Fazer upload de miniaturas.
Organização de arquivos
A API Drive organiza arquivos em locais de armazenamento, chamados de spaces
,
e coleções, chamadas de corpora
.
- Espaços
Locais de armazenamento específicos isolados uns dos outros. Todo o conteúdo em O Google Drive está armazenado em um destes dois espaços definidos:
drive
eappDataFolder
.drive
: inclui todos os arquivos visíveis ao usuário criados no Drive. PDFs, documentos, Documentos Google, atalhos e o outro conteúdo enviado pelo usuário está localizado no espaçodrive
.appDataFolder
: inclui dados de aplicativos por usuário. Aplicativos normalmente armazenam arquivos de configuração e outros dados que não devem ser diretamente acessíveis pelos usuários.
Não é possível mover os arquivos entre
spaces
.- Corpora
Coleções de arquivos usados para restringir o escopo das pesquisas de arquivos e pastas. O o corpora do Drive são:
user
,domain
,drive
eallDrives
.user
: inclui todos os arquivos criados e abertos pelo usuário em "Meu Drive", além daqueles compartilhados diretamente com o usuário em "Compartilhados comigo".drive
: inclui todos os arquivos contidos em um único drive compartilhado, como indicado pordriveId
.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 corporaallDrives
com cautela, porque eles têm um escopo amplo e podem afetar o desempenho. Quando possível, useuser
oudrive
em vez deallDrives
para eficiência.
Os arquivos podem ser movidos livremente entre
corpora
à medida que as permissões e a propriedade mudam.
Temas relacionados
Veja a seguir algumas das próximas etapas:
- Saiba como criar e gerenciar arquivos.
- Saiba como criar e preencher pastas.
- Saiba como fazer o upload de dados de arquivos.
- Saiba como fazer o download e exportar arquivos.
- Saiba como armazenar dados específicos do aplicativo.
- Saiba como mostrar o Seletor do Google em uma página.