Os limites e as cotas protegem a infraestrutura do Google contra um processo automatizado que usa a API Email Audit de maneira inadequada. O excesso de solicitações de uma API pode ser causado por um erro de digitação inofensivo ou por 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 quando ele atinge um limite é necessário para garantir a integridade geral do sistema do Google Workspace. Os limites ajudam a garantir 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#. Um exemplo de solicitações paralelas é pedir pequenos lotes de e-mails de diferentes usuários em vez de adicionar ou remover muitos e-mails de um usuário simultaneamente. No caso de linhas de execução, tente começar com 10, uma por e-mail de usuário. 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. Outro exemplo de compensação é a cota da API Email Audit para a taxa máxima geral de upload de mensagens. A taxa de upload é de uma solicitação de API por segundo por usuário, não importa quantas linhas de execução estejam fazendo solicitações de upload.
Para todos os erros baseados em tempo (máximo de N coisas por N 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
exponential backoff, aguarde um pequeno atraso antes de tentar novamente a chamada com falha. Um exemplo da API Email Audit para uma conversa é esperar 5 segundos e repetir 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 da solicitação 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.
A tabela a seguir lista os limites da API Email Audit:
| Categorias de limites de API | Limites |
|---|---|
| Criação de arquivos de caixa de e-mails criptografados |
A criação de arquivos de caixa de e-mails criptografados pode levar até vários dias para o sistema preparar, dependendo do tamanho. |
| Arquivos de caixa de e-mails criptografados, erros com exclusão |
Quando você exclui uma caixa de correio criptografada e ocorrem erros, a solicitação recebe o status |
A tabela a seguir lista as cotas da API Email Audit:
| Categorias de cota da API | Cotas |
|---|---|
| Tokens de autenticação do ClientLogin |
Válido por 24 horas. O erro é |
| Formatos de data |
Converta todas as datas para o formato de Tempo Universal Coordenado (UTC) antes de usá-las com a API Email Audit. Para mais informações, consulte o conversor de UTC. |
|
Arquivos de caixa de correio criptografados, resumos do |
O Google retém os arquivos criptografados da caixa de correio por três semanas. Depois desse período, eles são excluídos. É responsabilidade do administrador do domínio baixar esses arquivos de caixa de correio dentro desse período. |
| Arquivos de caixa de correio criptografados, formato |
Os arquivos de caixa de e-mail criptografados estão no formato mbox. |
| Arquivos de caixa de e-mails criptografados, número máximo de solicitações de criação |
O número máximo de solicitações de criação de exportação de caixa de correio por dia é de 100 para todos os administradores do domínio. |
| Status do arquivo da caixa de correio criptografada, paginação |
Ao solicitar o status de todas as solicitações de caixa de correio, as respostas podem
retornar grandes quantidades de dados. A API Email Audit agrupa esses dados em páginas, cada uma contendo um máximo de 100 entradas e um URI em uma tag |
| Monitor de e-mail |
O número máximo de solicitações de monitoramento de e-mail por dia é 1.500. Esse limite é para o domínio e inclui todas as solicitações feitas por qualquer administrador durante o dia. |
| Chave pública |
A API Email Audit só aceita uma chave. A chave pública usa o software GNU Privacy Guard (GPG). Ele está no formato PGP e é uma chave de criptografia RSA codificada em ASCII. Antes de fazer upload da chave pública, é necessário convertê-la em uma string codificada em base64. O arquivo de chave pública precisa ser lido com o conjunto de caracteres US-ASCII, (nome de conjunto de caracteres preferido da IANA para ASCII). |
| Pesquisas |
Os parâmetros |