Limites de uso

Como a API Google Drive é um serviço compartilhado, aplicamos cotas e limitações para garantir que ela seja usada de maneira justa por todos os usuários e para proteger o desempenho geral do sistema do Google Workspace.

Os limites são definidos em termos de unidades de cota, uma unidade de medida abstrata que representa o uso de recursos do Google Drive.

Cotas da API Drive

Três tipos de cotas são aplicados:

  • Por minuto por projeto: é o número de unidades de cota que seu projeto na nuvem do Google Cloud pode usar em um minuto.

  • Por minuto por usuário por projeto: é o número de unidades de cota que um usuário específico pode usar no projeto na nuvem. Esse limite ajuda a garantir uma distribuição justa do uso entre os usuários.

  • Por dia por projeto: define o número máximo de bytes que o projeto do Google Cloud pode transferir em um período de 24 horas antes que as cobranças sejam aplicadas.

A tabela a seguir detalha esses limites:

Tipo de limite de uso Limite
Por minuto e por projeto 1.000.000 de unidades de cota
Por minuto, por usuário e por projeto 325.000 unidades de cota
Por dia e por projeto 1 TB

Se você exceder uma cota, vai receber uma resposta de código de status HTTP 403: User rate limit exceeded. Outras verificações de limite de taxa no back-end do Drive também podem gerar uma resposta 429: Rate limit exceeded. Se isso acontecer, use um algoritmo de espera exponencial e tente novamente mais tarde.

Limite diário para faturamento

Esse limite por dia por projeto define o número máximo de unidades de cota que seu projeto do Google Cloud pode usar em um período de 24 horas antes que as cobranças sejam aplicadas.

O uso abaixo desse limite não gera cobranças extras, e sua conta do Google Cloud não é faturada. Os detalhes completos de faturamento serão compartilhados ainda em 2026, com pelo menos 90 dias de antecedência antes que qualquer mudança entre em vigor.

Não é possível solicitar um aumento desse limite diário.

A tabela a seguir detalha o limite:

Tipo de limite Limite
Por dia e por projeto 400.000.000 de unidades de cota

Para mais informações, consulte Modelo padronizado do Google Workspace para ferramentas e APIs de agentes.

Custos unitários de cota por método

O número de unidades de cota consumidas por solicitação varia de acordo com o método chamado, conforme descrito nas tabelas a seguir:

Métodos de leitura (5 unidades de cota)

Método
drive.about.get
drive.accessproposals.get
drive.apps.get
drive.approvals.get
drive.changes.get
drive.children.get
drive.comments.get
drive.drives.get
drive.files.get (without alt=media)
drive.parents.get
drive.permissions.get
drive.properties.get
drive.replies.get
drive.revisions.get (without alt=media)
drive.teamdrives.get

Métodos de lista (100 unidades de cota)

Método
drive.accessproposals.list
drive.apps.list
drive.changes.list, drive.changes.watch
drive.children.list
drive.comments.list
drive.drives.list
drive.files.list, drive.files.watch
drive.parents.list
drive.permissions.list
drive.properties.list
drive.replies.list
drive.revisions.list
drive.teamdrives.list

Métodos de edição (50 unidades de cota)

Método
drive.approvals.decline
drive.children.delete, drive.children.insert
drive.comments.create, drive.comments.delete, drive.comments.insert, drive.comments.patch, drive.comments.update
drive.drives.create, drive.drives.delete, drive.drives.hide, drive.drives.insert, drive.drives.unhide, drive.drives.update
drive.files.copy, drive.files.create, drive.files.delete, drive.files.emptyTrash, drive.files.insert, drive.files.modifyLabels, drive.files.patch, drive.files.touch, drive.files.trash, drive.files.untrash, drive.files.update
drive.parents.delete, drive.parents.insert
drive.permissions.create, drive.permissions.delete, drive.permissions.insert, drive.permissions.patch, drive.permissions.update
drive.properties.delete, drive.properties.insert, drive.properties.patch, drive.properties.update
drive.replies.create, drive.replies.delete, drive.replies.insert, drive.replies.patch, drive.replies.update
drive.revisions.delete, drive.revisions.patch, drive.revisions.update
drive.teamdrives.create, drive.teamdrives.delete, drive.teamdrives.insert, drive.teamdrives.update

Métodos de download (200 unidades de cota)

Método
drive.files.download, drive.files.export, drive.files.get (with alt=media)
drive.revisions.get (with alt=media)

Outros métodos (5 unidades de cota)

Método
drive.changes.getStartPageToken
drive.channels.stop
drive.files.generateCseToken, drive.files.generateIds, drive.files.listLabels
drive.operations.get
drive.permissions.getIdForEmail

Outras restrições

As seguintes restrições são aplicadas ao trabalhar com a API Drive:

  • Os usuários do Google Workspace só podem fazer upload de 750 GB por dia entre o Meu Drive e todos os drives compartilhados. Esse limite também se aplica a cópias.

  • Os usuários que atingirem o limite de 750 GB ou fizerem upload de um arquivo maior que 750 GB não poderão fazer upload ou copiar outros arquivos até que 24 horas tenham se passado.

  • O tamanho máximo de arquivo que os usuários podem enviar é de 5 TB. Apenas o primeiro arquivo que ultrapassa o limite conclui o upload. O tamanho máximo do arquivo que os usuários podem copiar é de 750 GB.

  • As notificações enviadas ao endereço especificado ao abrir um canal de notificação não são contabilizadas nos limites da cota. No entanto, as chamadas para os métodos changes.watch, channels.stop e files.watch são contabilizadas na sua cota.

  • Desde que você permaneça dentro das cotas por minuto, não há limite para o número de solicitações que podem ser feitas por dia.

  • Dependendo do tipo de conta do Google Workspace, há outros limites de armazenamento no Drive.

Resolver erros de cota baseados em tempo

Para todos os erros baseados em tempo (máximo de N solicitações por X minutos), recomendamos que seu código capture a exceção e use uma espera exponencial truncada para garantir que os dispositivos não gerem carga excessiva.

A espera exponencial é uma estratégia padrão de tratamento de erros para aplicativos de rede. Um algoritmo de espera exponencial repete solicitações usando tempos de espera exponencialmente crescentes entre as solicitações, até um tempo máximo de espera. Se as solicitações ainda não forem bem-sucedidas, é importante que os atrasos entre as solicitações aumentem ao longo do tempo até que a solicitação seja bem-sucedida.

Exemplo de algoritmo

Um algoritmo de espera exponencial repete solicitações exponencialmente, aumentando o tempo de espera entre novas tentativas até um tempo máximo de espera. Exemplo:

  1. Faça uma solicitação para a API Google Drive.
  2. Se a solicitação falhar, aguarde 1 + random_number_milliseconds e tente novamente.
  3. Se a solicitação falhar, aguarde 2 + random_number_milliseconds e tente novamente.
  4. Se a solicitação falhar, aguarde 4 + random_number_milliseconds e tente novamente.
  5. E assim por diante, até um tempo maximum_backoff.
  6. Continue aguardando e tentando até um número máximo de novas tentativas, mas não aumente o período de espera entre elas.

em que:

  • O tempo de espera é min(((2^n)+random_number_milliseconds), maximum_backoff), com n incrementado em 1 para cada iteração (solicitação).
  • random_number_milliseconds é um número aleatório de milissegundos menor ou igual a 1.000. Isso ajuda a evitar casos em que muitos clientes são sincronizados por alguma situação e todos tentam novamente ao mesmo tempo, enviando solicitações em ondas sincronizadas. O valor de random_number_milliseconds é recalculado após cada nova tentativa de solicitação.
  • maximum_backoff costuma ser 32 ou 64 segundos. O valor adequado depende do caso de uso.

O cliente pode continuar tentando novamente depois de maximum_backoff. As novas tentativas após esse ponto não precisam continuar aumentando o tempo de espera. Por exemplo, se um cliente usa um tempo maximum_backoff de 64 segundos, depois de atingir esse valor, ele pode tentar novamente a cada 64 segundos. Em algum momento, os clientes são impedidos de tentar novamente infinitas vezes.

O tempo de espera entre novas tentativas e o número de novas tentativas depende do seu caso de uso e das condições da rede.

Preços

Todo o uso padrão da API Google Drive está disponível sem custo financeiro adicional. Exceder os limites de solicitação de cota vai gerar cobranças na sua conta de faturamento do Google Cloud no final de 2026. Para mais informações, consulte o modelo padronizado do Google Workspace para ferramentas e APIs de agentes.

Solicitar aumento de cota

Dependendo do uso de recursos do projeto, talvez seja necessário solicitar um ajuste de cota. As chamadas de API feitas por uma conta de serviço são consideradas como se estivessem usando uma única conta. Solicitar uma cota ajustada não garante a aprovação. As solicitações de ajuste de cota que aumentam significativamente o valor da cota podem levar mais tempo para serem aprovadas.

Nem todos os projetos têm as mesmas cotas. À medida que você usa o Google Cloud com o tempo, seus valores de cota podem precisar aumentar. Se você espera um aumento significativo no uso, solicite ajustes de cota na página Cotas e limites do sistema no console do Google Cloud.

Para saber mais, consulte os seguintes recursos:

Cotas do servidor MCP do Drive

O servidor MCP do Drive usa uma métrica de alocação de custo de consulta. As tabelas a seguir detalham o custo de consulta para cada método de servidor MCP do Drive por seção:

Cotas do MCP do Drive

Dois tipos de cotas são aplicados:

  • Por minuto por projeto: é o custo da consulta para seu projeto na nuvem do Google Cloud por um minuto.

  • Por minuto, por usuário e por projeto: é o custo de consulta do projeto na nuvem do Google Cloud por um minuto que qualquer usuário específico pode usar.

A tabela a seguir detalha essas cotas:

Tipo de limite de uso Limite
Por minuto e por projeto 325.000
Por minuto, por usuário e por projeto 1.000.000

Cotas do conjunto de ferramentas do MCP do Drive

A tabela a seguir detalha o custo de consulta para cada conjunto de ferramentas do drivemcp.googleapis.com:

Endpoint Ferramenta Custo da consulta

/mcp/v1

copy_file

50

create_file

50

download_file_content

200

get_file_metadata

5

get_file_permissions

5

list_recent_files

100

read_file_content

200

search_files

100

Para mais informações, consulte a Referência da API Drive MCP.