Limites e cotas protegem a infraestrutura do Google de um processo automatizado que usa a API Groups Settings de maneira 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, é necessário bloquear o tráfego de uma origem específica quando ele atinge um determinado nível para a integridade geral do sistema do Google Workspace.
Falhas de solicitação de API
No caso improvável de falha da solicitação de API, o aplicativo recebe uma resposta de código de status HTTP. Um código de status HTTP 403 tem informações de erro que indicam quais cotas de API foram excedidas. A resposta permite que seu aplicativo personalizado detecte erros e tome as medidas
adequadas.
Solicitações urgentes
Se as suas 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 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 compensações e não é útil para todas as situações de API. Se o número de solicitações for muito alto, vão ocorrer erros de cota.
Erros baseados em tempo
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 repetir a chamada com falha. Um exemplo da API Groups Settings 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 as outras linhas de execução. Se a segunda solicitação não for bem-sucedida, seu aplicativo precisará 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 com falha. Além disso, decida qual é o limite de tentativas. Por exemplo, tente enviar uma solicitação novamente de cinco a sete vezes com tempos de atraso diferentes antes que o aplicativo
retorne um erro para o usuário.
Cotas
| Categorias de cota da API | Cotas |
|---|---|
| Consultas por dia | É possível fazer até 100 mil consultas por dia. Se você precisar de uma capacidade além deste limite, envie uma solicitação na página Cotas no console do Google Cloud. |
| Descrição do grupo, tamanho máximo | Você pode inserir uma descrição para o grupo com até 300 caracteres. |
| Nome do grupo, tamanho máximo | O nome do grupo pode ter até 60 caracteres. |
defaultMessageDenyNotificationText |
O texto da notificação pode ter até 10.000 caracteres. Para saber mais sobre a propriedade defaultMessageDenyNotificationText, consulte a referência da API.
|
maxMessageBytes |
O tamanho máximo padrão da mensagem é 1 MB. Para saber mais sobre a propriedade 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 suporta o formato Atom. Os formatos de dados JSON e Atom oferecem suporte a recursos completos de leitura e 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, consulte Ativar APIs Google Workspace. |