Os limites e as cotas protegem a infraestrutura do Google contra processos automatizados que usam 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 maneira ineficiente que faz chamadas de API desnecessárias. Seja qual for o motivo, bloquear o tráfego de uma origem específica quando ela atingir 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 possam ter um impacto negativo em toda a comunidade.
Se a solicitação da API falhar, você receberá uma resposta de código de status HTTP. O código de status 403 contém informações sobre erros de entrada incorreta, e o código de status HTTP 503 apresenta informações de erro que indicam quais cotas da API foram excedidas. Essas respostas permitem que o aplicativo personalizado detecte esses erros e tome as medidas apropriadas.
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 seu aplicativo Java ou C#. Por exemplo, divida suas solicitações por mês ou outro período. No caso de linhas de execução, tente começar com 10 linhas, uma por solicitação. A recomendação da 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, ocorrerão erros de cota.
Para todos os erros baseados no tempo (máximo de N itens por X segundos por linha de execução), principalmente os erros de código de status 503, recomendamos que o código capture a exceção e, usando um algoritmo de espera exponencial, aguarde um pouco antes de tentar novamente a chamada com falha. Um exemplo de API de configurações de e-mail 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, seu aplicativo deverá reduzir a frequência da solicitação até que a chamada seja bem-sucedida. Por exemplo, aumente o atraso inicial de 5 segundos para 10 segundos e tente novamente. Além disso, defina um limite para novas tentativas. Por exemplo, tente repetir uma solicitação de cinco a sete 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 expirou". |
| 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á no certificado formatado em X.509. Veja mais informações sobre as chaves de assinatura de Logon único baseadas em SAML em 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 dos Termos de Serviço do Google. Não use o logotipo do Google, o logotipo do Gmail ou quaisquer outros logotipos do Google. Para mais informações, consulte Políticas de logotipo e página de destino. |
| lista de permissões | Um ssoLIST é 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 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 seus registros MX não foram configurados para apontar para os sistemas do Google. Se você tiver atualizado seus registros e o status da verificação permanecer "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 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á seu 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 hora. |
Consulte a ISO 8601, representação numérica de datas e horas. |
| Tags de codificação de idioma | Veja 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á seu nome de domínio principal. Para informações sobre caracteres de nome da organização, consulte Uso de caracteres. |