Os limites e as cotas protegem a infraestrutura do Google de um processo automatizado que usa a API Admin 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, 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. Isso garante 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 que indicam 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 linhas de execução, comece com 10 linhas, uma por solicitação. Observação: a recomendação de linhas de execução 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 linha de execução), especialmente os erros de código de status 503, recomendamos que seu código detecte 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 linha de execução é aguardar 5 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, 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 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.
| Categorias de cotas de API | Cotas |
|---|---|
| Tokens de autenticação do ClientLogin | Válido por 24 horas. O erro é "401 token expirado". |
| Gerar chaves públicas e privadas |
Com seu provedor de identidade, gere um conjunto de chaves públicas e privadas chaves usando os algoritmos DSA ou RSA. A chave pública está no certificado formatado X.509. Para mais informações sobre as 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 no formato JPEG, PNG ou GIF. O tamanho recomendado é de 143 x 59 pixels, e o arquivo precisa ser menor que 20 KB. Ao usar logotipos personalizados, lembre-se de seguir os Termos de Serviço do Google Terms of Service. E evite usar o logotipo do Google, o do Gmail logotipo, ou qualquer outro logotipo do Google. Para mais informações, consulte Políticas de logotipo e página de destino. |
| ssoWhitelist |
| Outros tipos de limites | Limitações e diretrizes |
|---|---|
| Status de verificação de registro MX |
O status de verificação de registro MX padrão é `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 de 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 propagação, recomendamos que você aguarde o período definido pelo valor de tempo de vida (TTL) do registro MX e tente novamente. |
| 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 você queira solicitar um ajuste de cota ajuste. As chamadas de API por uma conta de serviço são consideradas como o uso de uma única conta. Solicitar uma cota ajustada não garante a aprovação. As solicitações de ajuste de cota que aumentariam 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 o Google Cloud com o tempo, os valores de cota podem precisar aumentar. Caso espere um aumento de uso significativo, solicite o ajuste das cotas com antecedência na página "Cotas" no console do Google Cloud.
Para saber mais, consulte os seguintes recursos: