Cotas e limites de uso

Os limites e as cotas protegem a infraestrutura do Google de processos automatizados que usam a API do Centro de alertas de maneira inadequada. O excesso de solicitações de uma API pode ser resultado de um erro de digitação inofensivo ou de um sistema projetado de forma ineficiente que faz chamadas desnecessárias para a API. Seja qual for a causa, bloquear o tráfego de uma fonte específica assim que ele atinge um limite é necessário para garantir a integridade geral do sistema do Google Workspace. Elas garantem que as ações de um desenvolvedor não afetem negativamente a comunidade de modo mais amplo.

No caso improvável de falha da sua solicitação de API, você vai receber uma resposta com um código de status HTTP. Um código de status 403 tem informações de erro sobre entrada incorreta, e um código de status HTTP 503 tem informações de erro indicando quais cotas da API foram excedidas. Essas respostas permitem que seu aplicativo personalizado detecte esses erros e tome as medidas adequadas.

Se as solicitações precisarem ser concluídas em um período fixo, envie-as em paralelo ou use várias linhas de execução no aplicativo Java ou C#. Um exemplo de solicitações paralelas é pedir pequenos lotes de e-mails de diferentes usuários em vez de adicionar ou remover muitos e-mails de um usuário simultaneamente. No caso de conversas, tente começar com 10, uma por e-mail de usuário. A recomendação de encadeamento tem compensações e não é útil para todas as situações de API. Se o número de solicitações ficar muito alto, ocorrerão erros de cota.

Para todos os erros baseados em tempo (máximo de N itens por N segundos por linha de execução), especialmente os erros de código de status 503, recomendamos que seu código capture a exceção e, usando um algoritmo de espera exponencial, aguarde um pequeno atraso antes de tentar novamente a chamada com falha. Um exemplo da API do Centro de alertas para uma linha de execução é esperar 5 segundos e tentar novamente a chamada com falha. Se a solicitação for bem-sucedida, repita esse padrão para as outras linhas de execução. Se a segunda solicitação não for bem-sucedida, o aplicativo vai reduzir a frequência até que uma chamada seja bem-sucedida. Por exemplo, aumente o atraso inicial de 5 segundos para 10 segundos e tente fazer a chamada novamente. Além disso, decida um limite de novas tentativas. Por exemplo, tente fazer uma solicitação de cinco a sete vezes com tempos de espera diferentes antes que o aplicativo retorne um erro ao usuário.

Categorias de limites de API Limites
Taxas de QPS e QPD da Central de alertas A API limita o número de solicitações para seu projeto do Console de APIs. O número máximo de solicitações por segundo (QPS do projeto) do projeto da API é 1.000. O número máximo de solicitações por usuário por segundo (QPS do usuário) é 150.

Se esses limites forem excedidos, o servidor vai retornar um código de status HTTP 503. Use o algoritmo de espera exponencial ao repetir as solicitações.

Outros tipos de limites Limitações e diretrizes
Formato de dados, padrão O formato de dados padrão é JSON.
Solicitações não autorizadas O Google não permite solicitações não autorizadas para essa API. Uma solicitação é considerada não autorizada se nenhum token de autorização for fornecido. Para mais informações, consulte Autorizar solicitações.

Solicitar um aumento de cota por projeto

Dependendo do uso de recursos do seu 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 usassem 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 mais o Google Cloud, os valores das cotas podem precisar aumentar. Caso espere um aumento de uso significativo, solicite o ajuste das cotas na página "Cotas" do console do Google Cloud.

Para saber mais, consulte os seguintes recursos: