Cotas e limites de uso

Os limites e as cotas protegem a infraestrutura do Google de um processo automatizado que usa a API Admin Settings 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 forma ineficiente que faz chamadas desnecessárias para a API. Seja qual for a causa, bloquear o tráfego de uma fonte específica assim que ele atinge um limite é necessário para garantir a integridade geral do sistema do Google Workspace. Elas garantem que as ações de um desenvolvedor não afetem negativamente a comunidade de modo mais amplo.

No caso improvável de falha da sua solicitação de API, você vai receber uma resposta de 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 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 threads, tente começar com 10 threads, um thread por solicitação. A recomendação de encadeamento tem compensações e não é útil para todas as situações de API. Se o número de solicitações ficar muito alto, ocorrerão erros de cota.

Para todos os erros baseados em tempo (máximo de N coisas por X 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 tentar novamente a chamada com falha. Um exemplo de API Email Settings para uma conversa é aguardar cinco segundos e tentar novamente 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, o aplicativo deverá reduzir a frequência até que uma chamada seja bem-sucedida. Por exemplo, aumente o atraso inicial de 5 segundos para 10 segundos e tente fazer a chamada novamente. Além disso, decida um limite de novas tentativas. Por exemplo, tente fazer uma solicitação de 5 a 7 vezes com diferentes tempos de atraso antes que o aplicativo retorne um erro ao usuário.

Categorias de cota da API Cotas
Tokens de autenticação do ClientLogin Válido por 24 horas. O erro é "401 token expired".
Como gerar chaves públicas e privadas

Com seu provedor de identidade, gere um conjunto de chaves públicas e privadas usando os algoritmos DSA ou RSA. A chave pública está em um certificado formatado X.509. Para mais informações sobre chaves de assinatura de Logon único baseado em SAML, consulte Gerar chaves e certificados para o serviço de Logon único do Google Workspace.
Logotipo

O arquivo de imagem do logotipo de uma conta pode estar nos formatos JPEG, PNG ou GIF. O tamanho recomendado é de 143 x 59 pixels, e o arquivo precisa ter menos de 20 KB. Ao usar logotipos personalizados, não se esqueça de obedecer aos Termos de Serviço do Google. e evite usar o logotipo do Google, do Gmail ou qualquer outro logotipo do Google. Para mais informações, consulte Políticas de logotipo e página de destino.
ssoWhitelist

Uma ssoWhitelist é um endereço IP de máscara de rede no formato de roteamento entre domínios sem classe (CIDR).
Outros tipos de limites Limitações e diretrizes
Status da verificação do registro MX

O status padrão da verificação de registro MX é "false", o que significa que o sistema do Google não verificou recentemente a configuração do registro MX ou que os registros MX não foram configurados para apontar para os sistemas do Google. Se você atualizou seus registros e o status da verificação continua sendo "false", isso pode significar que as atualizações do registro MX não foram propagadas ou que há um erro de digitação no registro. Para a propagação, recomendamos que você aguarde o tempo definido pelo valor de time to live (TTL) do registro MX e tente de novo.
Códigos de países

Se o nome da organização não tiver sido personalizado, o padrão será o nome de domínio principal. Para informações sobre caracteres de nome da organização, consulte Uso de caracteres.
Propriedade creationTime, representação numérica de datas e horas

Consulte a ISO 8601, representação numérica de datas e horas.
Tags de codificação de idioma

Consulte as tags de idioma RFC 3066 aceitas pelo Google Mail.
Nome da organização

Se o nome da organização não tiver sido personalizado, o padrão será o nome de domínio principal. Para informações sobre caracteres de nome da organização, consulte Uso de caracteres.

Solicitar um aumento de cota por projeto

Dependendo do uso de recursos do seu projeto, talvez seja necessário solicitar um ajuste de cota. As chamadas de API feitas por uma conta de serviço são consideradas como se usassem uma única conta. Solicitar uma cota ajustada não garante a aprovação. As solicitações de ajuste de cota que aumentam significativamente o valor da cota podem levar mais tempo para serem aprovadas.

Nem todos os projetos têm as mesmas cotas. À medida que você usa mais o Google Cloud, os valores das cotas podem precisar aumentar. Caso espere um aumento de uso significativo, solicite o ajuste das cotas na página "Cotas" do console do Google Cloud.

Para saber mais, consulte os seguintes recursos: