Limites e cotas protegem a infraestrutura do Google de um processo automatizado que usa a API Enterprise License Manager de forma inadequada. Solicitações excessivas de uma API podem resultar 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 suas solicitações precisarem ser concluídas em um período fixo, envie-as em lote. Dependendo da finalidade da API e se o número de solicitações for muito alto, ocorrerão erros de cota.
Se você não puder usar o recurso recomendado de solicitações em lote da API, use o algoritmo de espera exponencial. Para todos os erros baseados em tempo (máximo de N itens para X 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 a chamada com falha novamente. Um exemplo da API Enterprise License Manager 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 cota da API | Cotas |
|---|---|
| Consultas por segundo (QPS) | A cota de QPS é 1. |
| Categorias de limite da API | Limites |
|---|---|
| String de consulta maxResults | O tamanho máximo de maxResults é 100. |
| Outros tipos de limites | Limitações e diretrizes |
|---|---|
| Solicitações em lote |
A API é compatível com o envio de solicitações em lote. |
| Formato de dados nas respostas da API | O formato de dados da resposta é JavaScript Object Notation (JSON). |
| Como ativar a API Enterprise License Manager | A API Provisioning precisa ser ativada antes de fazer chamadas para a API Enterprise License Manager. No painel de controle, vá para a página Configurações da guia Usuários e grupos e ative a API de provisionar. Salve as mudanças. Além disso, o serviço Grupos do Google precisa estar ativado e ativado. |
| Solicitações não autorizadas | A API não aceita solicitações não autorizadas. Uma solicitação é considerada não autorizada se nenhum token de autorização é fornecido. Para mais informações, consulte Como autorizar solicitações . |