Limites e cotas protegem a infraestrutura do Google de um processo automatizado que usa a API Alert Center 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 maneira ineficiente que faz chamadas de API desnecessárias. Seja qual for a causa, bloquear o tráfego de uma origem específica quando ele atinge um determinado nível é necessário para a integridade geral do sistema do Google Workspace. Garante que as ações de um desenvolvedor não afetem negativamente a comunidade em geral.
No caso improvável de falha da sua solicitação de API, você vai receber uma resposta do 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 de 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 solicitações em paralelo ou use várias linhas de execução no aplicativo Java ou C#. Um exemplo de solicitações paralelas é solicitar pequenos lotes de e-mails de usuários diferentes, em vez de adicionar ou remover muitos e-mails de um usuário simultaneamente. No caso de conversas, tente começar com 10 conversas, uma por e-mail do usuário. A recomendação da linha de execução tem vantagens e desvantagens e não é útil para todas as situações da API. Se o número de solicitações ficar muito alto, erros de cota ocorrerão.
Para todos os erros baseados em tempo (máximo de N segundos por N segundos por thread), 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 repetir a chamada com falha. Um exemplo da API Alert Center para uma linha de execução é esperar cinco segundos e repetir a chamada com falha. Se a solicitação for bem-sucedida, repita esse padrão para os outros threads. Se a segunda solicitação não for bem-sucedida, seu aplicativo deverá reduzir a frequência da solicitação até que uma chamada seja bem-sucedida. Por exemplo, aumente o atraso inicial de 5 segundos para 10 segundos e repita a chamada que falhou. Decida também um limite de tentativas. Por exemplo, repita uma solicitação de cinco a sete vezes com tempos de atraso diferentes antes que o aplicativo retorne um erro para o usuário.
| Categorias de limite da API | Limites |
|---|---|
| Taxas de QPS e QPD da Central de alertas | A API limita o número de solicitações do 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. E o número máximo de solicitações por usuário por segundo (QPS de usuário) é 150.
Se esses limites forem excedidos, o servidor retornará um código de status HTTP |
| 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 é fornecido. Para mais informações, consulte Como autorizar solicitações. |
Solicitar um aumento de cota por projeto
Dependendo do uso de recursos do seu projeto, talvez seja necessário solicitar um aumento de cota. As chamadas de API realizadas por uma conta de serviço usam uma única conta. Solicitar uma cota maior não garante a aprovação. Grandes 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 ao longo do tempo, pode ser necessário aumentar as 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
- Conferir seus limites e uso de cota atuais
- Solicitar um limite de cota maior