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.

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

Se você exceder uma cota, receberá uma resposta do 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: Too many requests. Se isso acontecer, use um algoritmo de retirada exponencial e tente novamente mais tarde. Contanto que você se mantenha dentro das cotas por minuto abaixo, não há limite para o número de solicitações que podem ser feitas por dia.

A tabela a seguir detalha os limites de consulta:

Cotas
Consultas
Por 100 segundos 20.000
Por 100 segundos por usuário 20.000

Resolver erros de cota com base no tempo

Para todos os erros com base no tempo (no máximo N solicitações por X minutos), recomendamos que seu código capture a exceção e, usando um algoritmo de espera exponencial, implemente um pequeno atraso antes de tentar novamente. Se as solicitações ainda não tiverem êxito, é importante que os atrasos entre solicitações aumentem ao longo do tempo até que a solicitação seja bem-sucedida. Geralmente, é necessário usar uma espera exponencial truncada. Para saber como usar a espera exponencial, acesse Estratégia de repetição.

Preços

O uso da API Google Drive está disponível sem custo adicional. Exceder os limites de solicitação de cota não gera cobranças extras e sua conta não é faturada.

Solicitar aumento de cota

Dependendo do uso de recursos do projeto, é possível solicitar um aumento de cota. Considera-se que as chamadas de API de uma conta de serviço usam uma única conta. Portanto, talvez você precise de uma cota maior por usuário e por projeto nesse cenário. A solicitação de uma cota maior não garante a aprovação. O aumento de cotas pode levar mais tempo para ser aprovado.

Nem todos os projetos têm as mesmas cotas. À medida que você usa cada vez mais o Google Cloud, pode ser necessário aumentar suas cotas. Caso espere um aumento de uso significativo, solicite o ajuste das cotas na página "Cotas" no Console do Google Cloud.

Para saber mais, consulte os seguintes recursos: