Pastas são arquivos que contêm apenas metadados e podem ser usadas 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 sempre que um ID de arquivo for fornecido.
Saiba mais sobre os limites de pastas do Drive em Limites de arquivos e pastas.
Este guia explica como executar algumas tarefas básicas relacionadas a pastas.
Criar uma pasta
Para criar uma pasta, use o método files.create
com o tipo MIME
application/vnd.google-apps.folder
e um título. 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 método files.create
e especifique o ID da pasta na propriedade parents
do arquivo. A propriedade parents
contém os IDs da pasta
mãe que contêm o arquivo. 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
A propriedade parents
pode ser usada ao criar arquivos em uma pasta de nível superior ou
em qualquer outra pasta.
Mover arquivos entre pastas
Para mover arquivos, atualize o ID da propriedade parents
.
Para adicionar ou remover pais para um arquivo existente, use o método files.update
com os parâmetros de consulta addParents
e removeParents
. 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 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 ou fazer upload de itens no Drive. Eles ainda poderão ver e editar os itens existentes. Para criar os arquivos novamente, os usuários precisam excluir os itens permanentemente ou usar uma conta diferente. Para mais informações, consulte Excluir ou excluir arquivos e pastas.
Os objetos que contam para esse limite são:
- Itens criados ou enviados pelo usuário no Google 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
.
Limite de pasta e item
Cada pasta no Meu Drive de um usuário tem um limite de 500.000 itens. Esse limite não se aplica à pasta raiz do Meu Drive. Os itens contados para esse limite são:
- Pastas
- Arquivos. Todos os tipos de arquivo, independentemente da propriedade.
- Atalhos. Conta como um único item em uma pasta, mesmo que o item indicado não esteja nessa pasta. Para saber mais, consulte Criar um atalho para um arquivo do Drive.
- Atalhos de terceiros. Conta como um único item em uma pasta, mesmo que o item para o qual ele aponta não esteja nessa pasta. Para saber mais, 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 de pastas
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
resposta
de código de status HTTP
myDriveHierarchyDepthLimitExceeded
.