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
que 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 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
de 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 qualquer outra pasta.
Mover arquivos entre pastas
Para mover arquivos, atualize o ID da propriedade parents
.
Para adicionar ou remover pais de um arquivo atual, 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 do 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. O usuário ainda pode ver e editar os itens existentes. Para recriá-los, 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 por upload 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 são contabilizados nesse 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 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 se aplica à pasta raiz do Meu Drive. Os itens que contam 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 ver mais informações, consulte Criar um arquivo de atalho para o conteúdo armazenado pelo seu app.
Para mais informações sobre limites de pastas, consulte Limites de pastas no Google Drive.
Limite de tamanho 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 outra 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 armazena 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
.