Para facilitar a manipulação de arquivos, o Google Drive organiza arquivos em coleções, descreve por tipos e fornece atributos específicos para cada um.
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 deles. As coleções são especificadas como parte dos metadados do arquivo para mostrar com qual grupo de arquivos o arquivo está armazenado no Drive. A principal diferença entre as coleções do Meu Drive e dos drives compartilhados é a propriedade de arquivos. Um único usuário é o proprietário dos arquivos no Meu Drive, enquanto um grupo ou uma organização tem os 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 o que desce dessa pasta raiz. O usuário é o proprietário principal da pasta.
- Drives compartilhados
- Um drive compartilhado é uma estrutura organizacional dentro do Drive que é paralela ao Meu Drive. Você pode organizar um arquivo em um drive compartilhado ou no Meu Drive, mas não em ambos. 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 pode ser usado 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
.Observação:um único arquivo armazenado em "Meu Drive" pode estar contido em várias pastas. Um 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 saber mais, consulte Criar um atalho para um arquivo do Drive.- Atalho de terceiros
Um arquivo somente de metadados vinculado ao 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 saber mais, consulte Criar um atalho para um arquivo externo.- Documento do Google Workspace
Um arquivo que um aplicativo do Google Workspace cria, 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 das Planilhas Google). Veja uma lista de tipos MIME específicos do Drive e do Google Workspace em 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 no Drive ou para ele. No entanto, se eles usarem formatos compatíveis, você poderá fazer upload ou exportar documentos do Google Workspace. Por exemplo, você pode criar um documento Google ao importar um PDF. Da mesma forma, você pode exportar uma apresentação 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 arquivo são estáveis durante toda a vida útil do arquivo, mesmo que o nome dele mude. 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 nome, tipo, hora de criação e modificação. Alguns campos de metadados, como
name
, não dependem do usuário e são exibidos da mesma forma para cada um. Outros campos, comocapabilities
eviewedByMeDate
, contêm valores específicos do usuário. Tipos de arquivo, como imagens e vídeos, contêm outros metadados extraídos de EXIF e outros metadados incorporados. - Permissão
- Uma concessão de acesso para um usuário, grupo, domínio ou 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, na sigla em inglês), que é uma lista de permissões para o arquivo. Veja mais informações em Compartilhar arquivos, pastas e drives.
- Conteúdo
- O corpo binário ou de texto do arquivo. Alguns exemplos de conteúdo que você pode armazenar no Google Drive são imagens, vídeos, texto e PDF.
- Histórico de revisões
- O registro de alterações apenas no conteúdo do arquivo, não nos metadados dele. Para saber mais sobre as 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 arquivo comuns. Para atalhos e outros tipos de arquivo que o Drive não pode renderizar, você pode fornecer uma imagem em miniatura.
Organização de arquivos
A API Drive organiza os arquivos em locais de armazenamento, chamados spaces
, e coleções, chamados de corpora
.
- Espaços
Locais de armazenamento específicos isolados uns dos outros. Todo o conteúdo do Drive é armazenado em um destes dois espaços definidos:
drive
eappDataFolder
.drive
: inclui todos os arquivos visíveis para o usuário criados no Drive. PDFs, documentos, Documentos Google, atalhos e outros conteúdos que o usuário envia estão localizados no espaçodrive
.appDataFolder
: inclui dados do app por usuário. Os aplicativos geralmente armazenam arquivos de configuração e outros dados que não devem ser acessados diretamente pelos usuários.
Os arquivos não podem ser movidos entre espaços.
- Corpora
Coleções de arquivos usados para restringir o escopo das pesquisas de arquivos e pastas. Os corpora do Drive são:
user
,domain
,drive
eallDrives
.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 pelodriveId
.domain
: inclui todos os arquivos pesquisáveis compartilhados com o domínio do usuário.allDrives
: inclui todos os arquivos em drives compartilhados de que o usuário é membro e todos os arquivos em "Meu Drive" e "Compartilhados comigo". Use o corporaallDrives
com cuidado, porque ele tem um escopo amplo e pode afetar a performance. Sempre que possível, useuser
oudrive
em vez deallDrives
para aumentar a eficiência.
Os arquivos podem ser movidos livremente entre os corpora, à medida que as permissões e a propriedade mudam.
Próximas etapas
Veja a seguir algumas das próximas etapas:
- Saiba como fazer upload de dados de arquivos para o Drive.
- Saiba como fazer o download e exportar arquivos do Drive.
- Saiba como armazenar dados específicos de aplicativos.
- Saiba como mostrar o seletor do Google em uma página.