Os limites e as cotas protegem a infraestrutura do Google contra um processo automatizado que usa a API Admin 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. Independentemente da causa, bloquear o tráfego de uma origem específica quando ele atinge um determinado nível é necessário para a integridade geral do sistema do Google Workspace. Isso garante que as ações de um desenvolvedor não afetem negativamente a comunidade em geral.
No caso improvável de falha na solicitação de API, você vai receber uma resposta com um 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 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.
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 Email 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.
| 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 no formato X.509. Para mais informações sobre as chaves de assinatura de Logon único baseadas em SAML, consulte Como 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 ter menos de 20 KB. Ao usar logotipos personalizados, lembre-se de seguir os Termos de Serviço do Google. Não use o logotipo do Google, do Gmail ou qualquer outro logotipo do Google. Para mais informações, consulte as 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 de verificação do registro MX |
O status padrão de verificação do registro MX é "false", o que significa que o sistema do Google não verificou recentemente a configuração do seu registro MX ou que seus registros MX não foram configurados para apontar para os sistemas do Google. Se você atualizou seus registros e o status de verificação permanece falso, 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 novamente. |
| Códigos de países |
Se o nome da organização não tiver sido personalizado, o padrão será o nome do seu domínio principal. Para informações sobre caracteres de nome de 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 do seu domínio principal. Para informações sobre caracteres de nome de organização, consulte Uso de caracteres. |
Solicitar um aumento de cota por projeto
Dependendo do uso de recursos do projeto, talvez você queira solicitar um ajuste de cota. As chamadas de API feitas por uma conta de serviço são consideradas como se estivessem usando 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 o Google Cloud com o tempo, seus valores de cota podem precisar aumentar. Se você espera um aumento significativo no uso, solicite ajustes de cota na página Cotas e limites do sistema no console do Google Cloud.
Para saber mais, consulte os seguintes recursos: