Limites e cotas protegem a infraestrutura do Google de um processo automatizado que usa a API Groups Migration de maneira inadequada. Solicitações excessivas de uma API podem resultar 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 a causa, é necessário bloquear o tráfego de uma origem específica assim que ele atinge um determinado nível para a integridade geral do sistema do Google Workspace.
Falhas de solicitação de API
No caso improvável de falha da solicitação de API, o aplicativo recebe uma resposta de código de status HTTP. Um código de status HTTP 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.
Solicitações urgentes
Se as suas solicitações precisarem ser concluídas em um período fixo, envie as solicitações em paralelo ou use várias linhas de execução no seu 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 compensações 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.
Erros baseados em tempo
Para todos os erros baseados em tempo (máximo de N itens para 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 repetir a chamada com falha. Um exemplo da API Groups Migration para
uma linha de execução é esperar 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 repita a chamada que falhou. Além disso, defina um limite de tentativas. Por ]
exemplo, repita uma solicitação de cinco a sete vezes com tempos de atraso diferentes antes que o aplicativo retorne um
erro para o usuário.
Limites
| Categorias de limite da API | Limites |
|---|---|
| Consultas por segundo (QPS) | O limite do projeto de desenvolvedor é de 10 consultas por segundo (QPS) por conta. |
Cotas
| Categorias de cota da API | Cotas |
|---|---|
| Máximo de solicitações de API por dia | O número máximo de solicitações de API por dia é de 500.000. |
| Arquivamento, expiração de mensagens | Os arquivos do grupo não expiram. As mensagens permanecem no arquivo até que o grupo seja excluído. A política de retenção de e-mails não afeta as mensagens no arquivo do grupo. |
| Tamanho da mensagem de e-mail | O tamanho máximo das mensagens de e-mail é de 25 MB. Esse limite inclui os cabeçalhos, o corpo e os anexos de metadados da mensagem. |
Outros tipos de limites
| Outros limites | Limitações e diretrizes |
|---|---|
| Formatos de tipos de conteúdo | A mensagem de e-mail precisa estar no
formato de texto RFC 822 padrão.
Ao fazer o upload de e-mails migrados, o tipo de conteúdo da solicitação precisa usar o
cabeçalho Content-type: message/rfc822.
|
| Formato de dados nas respostas da API | O formato de dados da resposta é JavaScript Object Notation (JSON). |
| Políticas de localização de dados | A API Groups Migration não é compatível com políticas de localização de dados que exigem que os dados sejam armazenados em limites geográficos ou políticos específicos por motivos contratuais. Não use a API Groups Migration se o local dos dados for necessário para sua conta. |
| Inserções paralelas de mensagens | A API Groups Migration é compatível com solicitações paralelas de inserções de e-mail em diferentes arquivos de grupos. Mas a API Groups Migration não é compatível com inserções paralelas de mensagens no mesmo arquivo de grupo. Além disso, as solicitações em lote não são compatíveis com esta versão da API Groups Migration. |
| Solicitações não autorizadas | A API Groups Migration não aceita solicitações não autorizadas. Uma solicitação será considerada não autorizada se nenhum token de autorização for fornecido. Para mais informações, acesse Saiba mais sobre autenticação e autorização. |