Limites e cotas protegem a infraestrutura do Google de um processo automatizado que usa API Groups Settings de maneira inadequada. Solicitações excessivas de uma API podem resultar de uma erros de digitação inofensivos ou um sistema projetado de forma ineficiente que faz chamadas de API desnecessárias. Independentemente da causa, bloquear o tráfego de uma origem específica depois que ele atinge um determinado nível é necessárias para a integridade geral do sistema do Google Workspace.
Falhas na solicitação de API
No caso improvável de uma solicitação de API falhar, o aplicativo recebe um código de status HTTP
resposta. Um código de status HTTP de 403 tem informações de erro indicando quais cotas de API
foram excedidos. A resposta permite que seu aplicativo personalizado detecte erros e tome as medidas
à ação.
Solicitações urgentes
Se as solicitações precisarem ser concluídas em um período fixo, envie as solicitações em paralelo ou usar vários threads em seu aplicativo Java ou C#. Por exemplo, divida as solicitações por mês ou outro período. No caso de linhas de execução, tente começar com 10 linhas de execução, uma por solicitação. A recomendação de linha de execução tem vantagens e desvantagens e não é útil para todas as situações de API. Se o número de as solicitações ficarem muito altas, ocorrerem erros de cota.
Erros baseados em tempo
Para todos os erros baseados em tempo (máximo de N coisas para X segundos por thread), especialmente os
503 erros de código de status, recomendamos que seu código capture a exceção e usando
um
espera exponencial
, aguarde um pequeno atraso antes de tentar novamente a chamada com falha. Um exemplo da API Groups Settings para
uma linha de execução é esperar 5 segundos e tentar novamente a chamada com falha. Se a solicitação for bem-sucedida, repita
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 a chamada seja bem-sucedida. Por exemplo, aumente o
de 5 a 10 segundos e repita a chamada com falha. Além disso, escolha uma nova tentativa
ou ao atingir um limite estabelecido. Por exemplo, tente fazer uma solicitação de cinco a sete vezes com diferentes tempos de atraso antes que o aplicativo
retorna um erro para o usuário.
Cotas
| Categorias de cota da API | Cotas |
|---|---|
| Consultas por dia | Você pode fazer até 100.000 consultas por dia. Se você precisar de uma capacidade maior limite, envie uma solicitação do Página Cotas no console do Google Cloud |
| Descrição do grupo, tamanho máximo | É possível inserir uma descrição de grupo com até 4.096 caracteres. |
| Nome do grupo, tamanho máximo | O nome de um grupo pode ter até 60 caracteres. |
defaultMessageDenyNotificationText |
O texto da notificação pode ter até 10.000 caracteres. Para saber mais sobre o
defaultMessageDenyNotificationText, consulte a
Referência da API.
|
maxMessageBytes |
O tamanho máximo padrão da mensagem é 1 MB. Para saber mais sobre maxMessageBytes
, consulte a Referência da API.
|
Limites
| Tipos de limites | Limitações e diretrizes |
|---|---|
| Formato de dados, padrão |
O formato de dados padrão é JSON. A API também oferece suporte ao formato Atom. As APIs JSON e Atom os formatos de dados oferecem suporte a capacidades completas de leitura/gravação. Para mais informações, consulte Formatos de dados JSON e Atom. |
| API Groups Settings, ativação | Ative a API Directory antes de fazer chamadas para a API Groups Settings. Para mais informações, mais informações, consulte Ativar as APIs do Google Workspace. |