Os limites e as cotas protegem a infraestrutura do Google contra um processo automatizado que usa a API Groups Settings de maneira inadequada. Solicitações excessivas de uma API podem ser resultado de um erro de digitação inofensivo ou de um sistema projetado de forma ineficiente que faz chamadas de API desnecessárias. Seja qual for a causa, a integridade geral do sistema do Google Workspace exige o bloqueio do tráfego de uma origem específica quando ele atinge um determinado nível.
Falhas na solicitação de API
No caso improvável de falha na solicitação de API, seu aplicativo vai receber uma resposta com o código de status HTTP. Um código de status HTTP de 403 tem informações de erro
indicando quais cotas de API foram excedidas. A resposta permite que o aplicativo personalizado detecte erros e tome as medidas adequadas.
Solicitações urgentes
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#. 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 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 coisas por 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 novamente a chamada com falha. Um exemplo da API Groups Settings para uma linha de execução é aguardar 5 segundos e repetir a chamada com falha. Se a solicitação for bem-sucedida, repita esse padrão para as outras conversas.
Se a segunda solicitação não for bem-sucedida, o 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 tente novamente a chamada com falha. Além disso,
decida um limite de novas tentativas. Por exemplo, tente novamente uma solicitação de 5 a 7 vezes com tempos de atraso diferentes antes que o aplicativo retorne um erro ao usuário.
Cotas
| Categorias de cota da API | Cotas |
|---|---|
| Consultas por dia | É possível fazer até 100.000 consultas por dia. Se você precisar de capacidade além desse 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 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
a propriedade defaultMessageDenyNotificationText, consulte a
referência da API.
|
maxMessageBytes |
O tamanho máximo padrão da mensagem é de 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 é compatível com o formato Atom. Os formatos de dados JSON e Atom são compatíveis com 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 as APIs do Google Workspace. |