Cotas de uso da API Mail Admin Quarantine

A API Mail Admin Quarantine aplica cotas de uso por minuto para cada projeto na nuvem do Google Cloud para proteger a infraestrutura do Google Workspace que pesquisa e recupera mensagens em quarentena. As cotas são agrupadas pelo tipo de trabalho que um método realiza.

Cotas

A tabela a seguir lista as cotas. Cada cota é por minuto e por projeto na nuvem e conta todas as solicitações que o projeto faz em todos os clientes do Google Workspace e administradores personificados.

Cota Valor Métodos
Solicitações de pesquisa e lista 60 solicitações por minuto customers.quarantinedMessages.list, customers.quarantinedMessages.search
Solicitações de leitura 1.200 solicitações por minuto customers.quarantinedMessages.get, customers.quarantines.get, customers.quarantines.list, customers.operations.get
Solicitações de gravação 300 solicitações por minuto customers.quarantinedMessages.release, customers.quarantinedMessages.deny, customers.quarantinedMessages.batchRelease, customers.quarantinedMessages.batchDeny

Cada chamada de API conta como uma solicitação, independentemente do tamanho da página ou, para métodos em lote, do número de mensagens no lote. Por exemplo, uma solicitação batchRelease com 500 mensagens consome uma solicitação de gravação.

É possível ver o uso atual da cota do seu projeto no console do Google Cloud em APIs e serviços > APIs e serviços ativados > API Admin Quarantine > Cotas e limites do sistema.

Restrições de solicitação

Restrição Valor
Máximo de pageSize para solicitações list e search 300 mensagens
Máximo de mensagens por solicitação batchRelease ou batchDeny 500 mensagens
Janela de pesquisa e listagem Mensagens recebidas nos últimos 30 dias

Resolver erros de cota

Quando o projeto excede uma cota, a API retorna um erro HTTP 429 com o status RESOURCE_EXHAUSTED:

{
  "error": {
    "code": 429,
    "message": "Quota exceeded for quota metric 'Search and list quarantined messages requests' and limit 'Search and list requests per minute per project' of service 'mailadminquarantine.googleapis.com' for consumer 'project_number:123456789012'.",
    "status": "RESOURCE_EXHAUSTED"
  }
}

Para ficar dentro das cotas:

  • Tente novamente usando a espera exponencial. Quando você receber um erro 429, aguarde antes de tentar novamente e aumente o tempo de espera após cada tentativa com falha. Para mais detalhes, consulte Espera exponencial.
  • Use o maior tamanho de página útil. As solicitações de pesquisa e listagem têm a menor cota. Solicite até 300 mensagens por página em vez de muitas páginas pequenas.
  • Usar filtros. Restrinja as solicitações search com um filter ou query para recuperar apenas as mensagens necessárias.
  • Use métodos em lote para ações em massa. Uma única solicitação batchRelease ou batchDeny pode liberar ou negar até 500 mensagens, em comparação com uma mensagem por chamada release ou deny.
  • Pesquise operações com moderação. Ao aguardar uma operação em lote, chame o método get do recurso customers.operations a cada poucos segundos, em vez de continuamente.
  • Sincronize de forma incremental. Em vez de listar novamente toda a quarentena em cada execução, filtre por status = PENDING_TRIAGE e processe apenas as novas mensagens.

Os aumentos de cota não estão disponíveis durante a prévia para desenvolvedores. Se o seu caso de uso exigir cotas maiores, compartilhe seu feedback pelo Programa de prévia para desenvolvedores do Google Workspace.