Pastas são arquivos que contêm apenas metadados e podem ser usadas para organizar arquivos no Google Drive. Elas têm as seguintes propriedades:
- Uma pasta é um arquivo com o tipo MIME
application/vnd.google-apps.foldere não tem extensão. - O alias
rootpode ser usado para se referir à pasta raiz em qualquer lugar em que um ID de arquivo seja fornecido.
Para mais informações sobre os limites de pastas do Drive, consulte Limites de arquivos e pastas.
Este guia explica como realizar algumas tarefas básicas relacionadas a pastas.
Criar uma pasta
Para criar uma pasta, use o files.create()
método com o mimeType de application/vnd.google-apps.folder e um name.
O exemplo de código a seguir mostra como criar uma pasta usando uma biblioteca de cliente:
Java
Python
Node.js
PHP
.NET
Criar um arquivo em uma pasta específica
Para criar um arquivo em uma pasta específica, use o files.create() método e especifique o ID da pasta na
parents propriedade do arquivo.
A propriedade parents contém o ID da pasta mãe que contém o arquivo.
A propriedade parents pode ser usada ao criar arquivos em uma pasta de nível superior ou em qualquer outra pasta.
Um arquivo só pode ter uma pasta mãe. Não é possível especificar vários pais. Se o campo parents não for especificado, o arquivo será colocado diretamente na pasta Meu Drive do usuário.
O exemplo de código a seguir mostra como criar um arquivo em uma pasta específica usando uma biblioteca de cliente:
Java
Python
Node.js
PHP
.NET
Mover arquivos entre pastas
Para mover arquivos, atualize o ID da propriedade parents.
Para adicionar ou remover pais de um arquivo atual, use o files.update() método com os parâmetros de consulta addParents e
removeParents.
Um arquivo só pode ter uma pasta mãe. Não é possível especificar vários pais.
O exemplo de código a seguir mostra como mover um arquivo entre pastas usando uma biblioteca de cliente:
Java
Python
Node.js
PHP
.NET
Limites de arquivos e pastas
Os arquivos e pastas do Drive têm alguns limites de armazenamento.
Limite de itens por usuário
Cada usuário pode ter até 500 milhões de itens criados por essa conta. Quando o limite é atingido, o usuário não pode mais criar ou fazer upload de itens no Drive. Ele ainda pode visualizar e editar itens atuais. Para criar arquivos novamente, os usuários precisam excluir os itens permanentemente ou usar outra conta. Para mais informações, consulte Colocar arquivos e pastas na lixeira ou excluir .
Os objetos que contam para esse limite são:
- Itens criados ou enviados pelo usuário no Drive
- Itens criados pelo usuário, mas que agora pertencem a outra pessoa
- Itens na lixeira
- Atalhos
- Atalhos de terceiros
Os objetos que não contam para esse limite são:
- Itens excluídos permanentemente
- Itens compartilhados com o usuário, mas que pertencem a outra pessoa
- Itens que pertencem ao usuário, mas foram criados por outra pessoa
As tentativas de adicionar mais de 500 milhões de itens retornam uma resposta de código de status
activeItemCreationLimitExceeded
HTTP.
As contas de serviço não podem ter arquivos. Em vez disso, elas precisam fazer upload de arquivos e pastas para drives compartilhados ou usar o OAuth 2.0 para fazer upload de itens em nome de um usuário humano.
Limite de itens por pasta
Cada pasta no Meu Drive de um usuário tem um limite de 500.000 itens. Esse limite não é válido para a pasta raiz do Meu Drive. Os itens que contam para esse limite são:
- Pastas
- Arquivos. Todos os tipos de arquivo, independente da propriedade.
- Atalhos. Contam como um único item em uma pasta, mesmo que o item para o qual ele aponte não esteja nessa pasta. Para mais informações, consulte Criar um atalho para um arquivo do Drive.
- Atalhos de terceiros. Contam como um único item em uma pasta, mesmo que o item para o qual ele aponte não esteja nessa pasta. Para mais informações, consulte Criar um arquivo de atalho para conteúdo armazenado pelo app.
Para mais informações sobre os limites de pastas, consulte Limites de pastas no Google Drive.
Limite de profundidade da pasta
O Meu Drive de um usuário não pode conter mais de 100 níveis de pastas aninhadas. Isso significa que uma pasta filha não pode ser armazenada em uma pasta com mais de 99 níveis de profundidade. Essa limitação só se aplica a pastas filhas. Um arquivo filho
com um tipo MIME diferente de
application/vnd.google-apps.folder está isento dessa limitação.
Por exemplo, no diagrama a seguir, uma nova pasta pode ser aninhada dentro da pasta número 99, mas não dentro da pasta número 100. No entanto, a pasta número 100 pode armazenar arquivos como qualquer outra pasta do Drive:
As tentativas de adicionar mais de 100 níveis de pastas retornam uma
myDriveHierarchyDepthLimitExceeded
resposta de código de status HTTP.
Temas relacionados
- Criar e gerenciar arquivos
- Gerenciar metadados de arquivos
- Limites de arquivos e pastas em drives compartilhados