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 é fornecido.
Para mais informações sobre limites de pastas do Google Drive, consulte Arquivos e limites de pasta.
Este guia explica como executar algumas tarefas básicas relacionadas a pastas.
Criar uma pasta
Para criar uma pasta, use files.create
.
com o MIME application/vnd.google-apps.folder
tipo 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
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
qualquer outra pasta.
Um arquivo só pode ter uma pasta principal. especificar vários pais não é suporte.
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 método files.update
com os elementos addParents
e
Parâmetros de consulta removeParents
.
Um arquivo só pode ter uma pasta principal. especificar vários pais não é suporte.
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 Google Drive. O usuário ainda pode ver e editar os itens existentes. Para criar arquivos novamente, os usuários precisarão 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 de propriedade do usuário, mas criados por outra pessoa
As tentativas de adicionar mais de 500 milhões de itens retornam um
activeItemCreationLimitExceeded
Resposta do código de status HTTP.
Embora não haja limite para o número de itens que uma conta de serviço pode o limite de 500 milhões de itens se aplica ao número de itens que uma conta de serviço podem 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. 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 aponta não está na pasta. Para mais informações, consulte Criar um atalho para um arquivo do Drive.
- Atalhos de terceiros. Conta como um único item em uma pasta, mesmo que o para o qual ele aponta não está nessa pasta. Para mais informações, consulte Crie um arquivo de atalho para o conteúdo armazenado pelo seu app.
Para mais informações sobre limites de pastas, consulte Limites de pastas em Google Drive.
Limite de tamanho da pasta
O Meu Drive de um usuário não pode conter mais de 100 níveis de itens aninhados
do Google Cloud. Isso significa que uma pasta filha não pode ser armazenada em outra
com mais de 99 níveis. Essa limitação só se aplica a pastas filhas. Uma criança
arquivo com um tipo MIME que não seja
application/vnd.google-apps.folder
está isento dessa limitação.
Por exemplo, no diagrama a seguir, uma nova pasta pode ser aninhada dentro de uma pasta. número 99, mas não dentro da pasta número 100. Porém, a pasta número 100 pode armazenar como qualquer outra pasta do Drive:
As tentativas de adicionar mais de 100 níveis de pastas retorna um
myDriveHierarchyDepthLimitExceeded
Resposta do código de status HTTP.