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 |
|
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:
- Sobre as solicitações de aumento de cota
- Ver os limites e o uso atual da cota
- Solicitar um limite de cota maior