As pastas são arquivos que contêm apenas metadados e podem ser usados para organizar arquivos no Google Drive. Eles têm as seguintes propriedades:
- Uma pasta é um arquivo com o tipo MIME
application/vnd.google-apps.folder
e não tem extensão. - O alias
root
pode 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 método files.create
com o application/vnd.google-apps.folder
tipo
MIME e um título. O exemplo de código abaixo 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 método files.create
e especifique o ID da pasta na
propriedade parents
do arquivo.
A propriedade parents
contém o ID da pasta pai 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.
O exemplo de código abaixo 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, use o método files.update
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 abaixo 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 as 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 que foram criados por essa conta. Quando o limite é atingido, o usuário não pode mais criar nem fazer upload de itens no Drive. Ainda será possível ver e editar os itens existentes. Para criar arquivos novamente, os usuários precisam excluir os itens permanentemente ou usar outra conta. Para mais informações, consulte Esvaziar a Lixeira ou excluir arquivos e pastas.
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 HTTP
activeItemCreationLimitExceeded
.
Embora não haja limite para o número de itens que uma conta de serviço pode ter, o limite de 500 milhões de itens se aplica ao número de itens que uma conta de serviço pode criar.
Limite de itens de 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 são contabilizados nesse limite são:
- Pastas
- Arquivos. Todos os tipos de arquivo, independentemente da propriedade.
- Atalhos. É contabilizado como um único item em uma pasta, mesmo que o item para o qual ele aponta não esteja nessa pasta. Para mais informações, consulte Criar um atalho para um arquivo do Drive.
- Atalhos de terceiros. É contabilizado 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. Essa limitação se aplica apenas 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
resposta de código de status HTTP
myDriveHierarchyDepthLimitExceeded
.