Limites e cotas protegem a infraestrutura do Google de um processo automatizado que usa a API Reports de maneira inadequada. Solicitações excessivas de uma API podem resultar de um erro de digitação inofensivo ou podem resultar de um sistema projetado de forma 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. Ela garante que as ações de um desenvolvedor não afetem negativamente a comunidade em geral.
No caso improvável de uma solicitação de API falhar, você receberá uma resposta do código de status HTTP. Um código de status 403 tem informações de erro sobre uma entrada incorreta, e um código de status HTTP 503 tem informações de erro indicando quais cotas da 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 solicitações em paralelo ou use várias linhas de execução no seu aplicativo Java ou C#. Um exemplo de solicitação paralela é solicitar pequenos lotes de e-mails de usuários diferentes em vez de adicionar ou remover vários e-mails de um usuário simultaneamente. No caso de conversas, tente começar com dez conversas, uma por e-mail do usuário. A recomendação de linha de execução tem desvantagens e não é útil para todas as situações da API. Se o número de solicitações for muito alto, ocorrerão erros de cota.
Para todos os erros baseados em tempo (máximo de N itens por N 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 tentar novamente a chamada com falha. Um exemplo da API Reports 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 deve diminuir 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 outra vez a chamada que falhou. Defina também 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.
| Categorias de limite da API | Limites |
|---|---|
| Taxas de QPS e QPD do relatório | A API limita o número de solicitações para seu projeto do Google Cloud.
O valor padrão definido no console do Google Cloud é de 2.400 consultas por minuto por usuário a cada projeto do Google Cloud.
É possível aumentar esse limite na página "Cotas" da API Admin SDK do projeto do Google Cloud.
Se esses limites forem excedidos, o servidor retornará um código de status HTTP 503. Use o algoritmo de espera exponencial ao repetir suas solicitações. |
| Categorias de cota da API | Cotas |
| maxResults | O número de registros listados em cada página de resposta de uma API varia de 1 a 1.000 eventos. O padrão é de 1.000 registros. |
| Outros tipos de limites | Limitações e diretrizes |
|---|---|
| Formato de dados, padrão | O formato de dados padrão é JSON. A API também suporta o formato Atom. |
| Solicitações não autorizadas | O Google não permite solicitações não autorizadas à API. Uma solicitação é considerada não autorizada se nenhum token de autorização é fornecido. Para mais informações, consulte Autorizar solicitações. |
| Mensagens de aviso |
|