Visão geral de arquivos e pastas

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

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

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 da metadados do arquivo para mostrar em qual grupo de arquivos ele está armazenado Google 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 uma organização são proprietários de 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 é proprietário principal dessa pasta.
Drives compartilhados
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 para arquivos ou pastas de drives compartilhados no 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.

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 principal.

Atalho

Um arquivo somente de metadados que aponta para outro arquivo em Google 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 vincula ao conteúdo armazenado em um em um sistema de armazenamento externo. O tipo MIME do arquivo de atalho de terceiros é application/vnd.google-apps.drive-sdk: Para mais informações, 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 como application/vnd.google-apps.spreadsheet para um arquivo do Planilhas Google ). Para uma lista de configurações específicas do Drive e do Google Workspace Tipos MIME, consulte Google Workspace e Tipos MIME compatíveis com o Google Drive.

Observação:não é possível fazer o upload ou o download de pastas, atalhos, pastas atalhos de teclado e documentos do Google Workspace de ou para o Drive. 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 quando: 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ável durante a vida útil do arquivo, mesmo se o nome dele mudar. 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 o name, não depende de um usuário e é igual para todos eles. Outra opção campos, como capabilities e viewedByMeDate, contêm instruções valores. Os outros 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 o mundo acessar um arquivo ou uma hierarquia de pastas. Os usuários controlam quem pode acessar um arquivo com o lista de controle de acesso (ACL, na sigla em inglês), que é uma lista de permissões para o arquivo. Para mais informações, consulte Compartilhar arquivos, pastas e unidades de disco.
Conteúdo
O corpo binário ou de texto do arquivo. Alguns exemplos de conteúdo que você pode armazenados no Google Drive são imagens, vídeos, texto e PDF.
Histórico de revisões
O registro de alterações somente no conteúdo do arquivo, não no metadados do arquivo. Para mais detalhes sobre revisões, consulte Alterações e revisões geral.
Miniatura
Uma representação gráfica de um arquivo. Carro gera automaticamente miniaturas para muitos tipos comuns de arquivo. Para atalhos e outros tipos de arquivo que o Drive não renderiza, você pode uma imagem em miniatura.

Organização de arquivos

A API Drive organiza arquivos em locais de armazenamento, chamados spaces, e coleções, chamados corpora.

Espaços

Locais de armazenamento específicos isolados uns dos outros. Todos 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 em Google Drive. PDFs, documentos, Documentos Google, atalhos e o outro conteúdo enviado pelo usuário está localizado no espaço drive.

  • appDataFolder: inclui dados do app 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 os espaços.

Corpora

Coleções de arquivos usados para restringir o escopo do arquivo e da pasta pesquisas. Os corpora do Google Drive são: user, domain, drive e allDrives.

  • user: inclui todos os arquivos criados e abertos pelo usuário em "Meu Drive" e as que foram compartilhadas diretamente com o usuário em comigo".

  • drive: inclui todos os arquivos contidos em um único drive compartilhado. indicado por driveId.

  • domain: inclui todos os arquivos pesquisáveis compartilhados com o domínio.

  • allDrives: inclui todos os arquivos nos drives compartilhados em que o usuário está um membro e todos os arquivos em "Meu Drive" e "Compartilhados comigo". Use o corpora allDrives com cuidado, porque ele tem um escopo amplo e pode afetar o desempenho. Quando possível, use user ou drive em vez de allDrives para eficiência.

Os arquivos podem ser movidos livremente entre os corpora conforme as permissões e a propriedade mudam.

Próximas etapas

Veja a seguir algumas das próximas etapas: