Limites de uso

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

As notificações entregues no endereço especificado quando abrir um canal de notificação não são contabilizados nos seus limites de cota. No entanto, chamadas para o changes.watch, channels.stop e Métodos files.watch são contabilizados sua cota.

Se você exceder uma cota, vai receber uma solicitação de 403: User rate limit exceeded Resposta do código de status HTTP. Outras verificações de limites de taxa O back-end do Drive também pode gerar um 429: Too many requests resposta. Se isso acontecer, use uma espera exponencial algoritmo e tente novamente mais tarde. Contanto que você se mantenha dentro cotas por minuto abaixo, não há limite para o número de solicitações que você pode fazer por dia.

A tabela a seguir mostra os limites das consultas:

Cotas
Consultas
Por 60 segundos 12.000
A cada 60 segundos, por usuário 12.000

Resolver erros de cota baseada em tempo

Para todos os erros com base em tempo (máximo de N solicitações por X minutos), recomendamos o código capturar a exceção e usar uma espera exponencial truncada para garantir que não geram carga excessiva.

A espera exponencial é uma estratégia padrão de tratamento de erros para aplicativos de rede. Um o 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 tiverem sido 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 de novo da solicitação.
  3. Se a solicitação falhar, aguarde 2 + random_number_milliseconds e tente de novo. da solicitação.
  4. Se a solicitação falhar, aguarde 4 + random_number_milliseconds e tente de novo da solicitação.
  5. E assim por diante, até um tempo maximum_backoff.
  6. Continue aguardando e tentando até um número máximo de novas tentativas, sem aumentar a espera. e o intervalo entre novas tentativas.

em que:

  • O tempo de espera é de 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 que ou igual a 1.000. Isso ajuda a evitar casos nos quais muitos clientes são sincronizados pela em algumas situações e todos tentam novamente ao mesmo tempo, enviando solicitações ondas O valor de random_number_milliseconds é recalculado após cada repetir a solicitação.
  • maximum_backoff costuma ser 32 ou 64 segundos. O valor apropriado 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. Para exemplo, se um cliente usar um tempo de maximum_backoff de 64 segundos, depois de atingir esse valor, o cliente poderá tentar novamente a cada 64 segundos. Em algum momento, os clientes devem ser impedidos de tentar novamente indefinidamente.

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

Preços

O uso da API Google Drive está disponível sem custo adicional. Cota excedida os limites de solicitações não acarreta cobranças adicionais e sua conta não é faturada.

Solicitar aumento de cota

Dependendo do uso de recursos do seu projeto, talvez seja necessário solicitar uma cota aumentam. Considera-se que chamadas de API por uma conta de serviço usam um conta única. A solicitação para aumentar a cota não garante a aprovação. Grande os aumentos de cota podem levar mais tempo para serem aprovados.

Nem todos os projetos têm as mesmas cotas. Conforme você usa cada vez mais o Google Cloud as cotas podem precisar aumentar. Se você espera um futuro incrível de uso, você poderá tomar medidas solicitar ajustes de cota na página "Cotas" no console do Google Cloud.

Para saber mais, consulte os recursos a seguir: