Os limites e as cotas protegem a infraestrutura do Google contra processos automatizados que usam a API Email Audit de maneira inadequada. O excesso de solicitações de uma API pode resultar de um erro de digitação inofensivo ou de um sistema projetado de maneira ineficiente. 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. Os limites ajudam a garantir que as ações de um desenvolvedor não afetem negativamente a comunidade maior.
Se a solicitação da API falhar, você receberá uma resposta de código de status HTTP. Um código de status de 403 tem informações de erro sobre uma entrada incorreta, e
um código de status HTTP de 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 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#. Um exemplo de solicitações paralelas é solicitar pequenos lotes de e-mails de diferentes usuários em vez de adicionar ou remover vários e-mails de um usuário simultaneamente. No caso de linhas de execução, tente começar com 10 linhas, uma por e-mail de usuário. A recomendação da linha de execução tem 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. 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 é uma solicitação de API por segundo por usuário, independentemente de quantas linhas de execução estejam fazendo solicitações de upload.
Para todos os erros baseados no tempo (máximo de N itens por N 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 pequeno atraso antes de tentar a chamada com falha novamente. Um exemplo de API de auditoria de e-mail de uma linha de execução é aguardar cinco 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, seu 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 fazer a chamada com falha
novamente. Além disso, defina um limite para novas tentativas. Por exemplo, tente fazer uma solicitação de cinco a sete vezes com tempos de atraso diferentes
antes que o aplicativo retorne um erro ao usuário.
A tabela a seguir lista os limites da API Email Audit:
| Categorias de limite da API | Limites |
|---|---|
| Arquivos de caixa de correio criptografados, criação | A criação de arquivos criptografados da caixa de e-mails pode levar vários dias para ser preparada, dependendo do tamanho do sistema. |
| Arquivos da caixa de e-mails criptografados, erros na exclusão | Quando ocorre exclusão de uma caixa de e-mails criptografada e erros, a solicitação recebe um status MARKED_DELETE. Esses resumos e arquivos de exportação são automaticamente excluídos para exclusão pelo Google dentro de 24 horas (com os possíveis arquivos restantes). Se o status de MARKED_DELETE for retornado
consistentemente, tente uma estratégia de espera exponencial.
|
Veja na tabela a seguir as cotas da API Email Audit:
| Categorias de cota de API | Cotas |
|---|---|
| Tokens de autenticação do ClientLogin | Válido por 24 horas. O erro é 401 token expired.
|
| Formatos de data | Converta todas as datas para o formato de data/hora universal coordenada (UTC) antes de usá-las com a API de auditoria de e-mail. Para mais informações, consulte o conversor UTC. |
Arquivos da caixa de e-mails criptografados, EXPIRED resumos e arquivos de exportação
|
O Google retém os arquivos criptografados por três semanas. Após esse período, eles são excluídos. É de responsabilidade do administrador do domínio fazer o download desses arquivos da caixa de e-mails dentro desse período. |
| Arquivos da caixa de e-mails criptografados, formato | Os arquivos de caixa de e-mails criptografados estão no formato mbox. |
| Arquivos criptografados da caixa de e-mails, número máximo de solicitações de criação | O limite diário de solicitações de criação de exportação de caixa de e-mails é de 100 solicitações de todos os administradores do domínio. |
| Status de arquivo da caixa de e-mails criptografado, paginação | Ao solicitar o status de todas as solicitações de caixa de e-mails, as respostas podem retornar grandes quantidades de dados. A API Email Audit agrupa esses dados em páginas com cada
página contendo no máximo 100 entradas e um URI em uma tag link rel='next' que aponta para a próxima
página de resultados. Ao desenvolver seu aplicativo cliente, o código precisa gerenciar esses
resultados adicionais.
|
| Monitor de e-mail | O número máximo de solicitações de monitoramento de e-mail por dia é 1.500. Esse limite é aplicável ao domínio e inclui todas as solicitações feitas por qualquer administrador durante o dia. |
| Chave pública | A API Email Audit é compatível com apenas uma chave.
A chave pública usa o software GNU Privacy Guard (GPG). Ela está no formato PGP e é uma chave de criptografia RSA codificada em ASCII. Antes de fazer upload da chave pública, você precisa convertê-la em uma string codificada em base64. O arquivo de chave pública precisa ser lido com o conjunto de caracteres US-Async, (nome de conjunto de caracteres preferencial da IANA para ASCII). |
| Pesquisando… | Os parâmetros searchQuery e includeDeleted são mutuamente exclusivos. Não será possível fazer uma consulta de pesquisa se includeDeleted="true".
|