Cotas

As cotas protegem a infraestrutura do Google de processos automatizados que usam a API Google Bid Manager de maneira inadequada. Elas garantem que as ações de um desenvolvedor não afetem negativamente a comunidade em geral.

Limites de cota

Os seguintes limites de cota padrão são compartilhados por todos os recursos e métodos da API Bid Manager.

• 2.000 solicitações por projeto por dia. É possível aumentar esse número.
• 4 consultas por segundo (QPS) por projeto
  • No Console de APIs do Google, essa cota é chamada de consultas por minuto e usuário e está definida como 240.

Observação: as cotas diárias são atualizadas à meia-noite na Hora do Pacífico.

Limites de cota excedentes

No caso improvável de a sua solicitação falhar por exceder um limite de cota, a API retorna um código de status HTTP e o motivo do erro. Além disso, o corpo da resposta vai conter uma descrição detalhada do que causou o erro. Consulte o guia Mensagens de erro para ver um exemplo de resposta de erro.

A lista a seguir mostra os possíveis erros e as ações recomendadas para falhas de solicitação causadas pelo excesso de limites de cota.

Código	Motivo	Mensagem	Ação recomendada
403	dailyLimitExceeded	Limite diário excedido	Não tente novamente sem resolver o problema. Analise o uso do Console de APIs do Google e modifique seu fluxo de trabalho para fazer menos solicitações. É possível solicitar uma cota adicional se você acredita que seu uso é razoável.
403	userRateLimitExceeded	O limite de taxa de usuário foi excedido	Diminua a taxa de envio de solicitações usando a espera exponencial.

O que é espera exponencial?

A espera exponencial é uma estratégia padrão de tratamento de erros para aplicativos de rede em que o cliente repete periodicamente uma solicitação com falha ao longo de um período crescente. Se um alto volume de solicitações ou o tráfego de rede intenso faz com que o servidor retorne erros, a espera exponencial pode ser uma boa estratégia para tratar esses erros. Por outro lado, essa não é uma estratégia relevante para tratar erros não relacionados ao volume de rede ou a tempos de resposta, como credenciais de autorização inválidas ou erros de arquivo não encontrado.

Usada corretamente, a espera exponencial aumenta a eficiência do uso da largura de banda, reduz o número de solicitações necessárias para conseguir uma resposta bem-sucedida e maximiza a capacidade de solicitações em ambientes simultâneos.

O fluxo para implementação da espera exponencial simples é o seguinte:

1. Faça uma solicitação para a API.
2. Receba uma resposta HTTP 503, que indica que você precisa repetir a solicitação.
3. Aguarde um segundo + random_number_milliseconds e envie novamente a solicitação.
4. Receba uma resposta HTTP 503, que indica que você precisa repetir a solicitação.
5. Aguarde dois segundos + random_number_milliseconds e envie novamente a solicitação.
6. Receba uma resposta HTTP 503, que indica que você precisa repetir a solicitação.
7. Aguarde 4 segundos + random_number_milliseconds e repita a solicitação.
8. Receba uma resposta HTTP 503, que indica que você deve repetir a solicitação.
9. Aguarde 8 segundos + random_number_milliseconds e repita a solicitação.
10. Receba uma resposta HTTP 503, que indica que você deve repetir a solicitação.
11. Aguarde 16 segundos + random_number_milliseconds e repita a solicitação.
12. Pare. Informe ou registre um erro.

No fluxo acima, random_number_milliseconds é um número aleatório de milissegundos menor ou igual a 1.000. Isso é necessário, uma vez que a introdução de um pequeno atraso aleatório ajuda a distribuir a carga de maneira mais uniforme e evitar a possibilidade de falha do servidor. Após cada espera, é preciso redefinir o valor de random_number_milliseconds.

Observação: a espera é sempre (2 ^ n) + random_number_milliseconds, em que n é um número inteiro monótono crescente inicialmente definido como 0. O número inteiro n é incrementado em 1 para cada iteração (cada solicitação).

O algoritmo é definido para terminar quando n for 5. Esse limite impede que os clientes fiquem tentando infinitamente e gera um atraso total de cerca de 30 segundos antes de uma solicitação ser considerada "um erro irrecuperável". Um número máximo maior de tentativas não é um problema, especialmente se um upload longo estiver em andamento. No entanto, use um atraso de repetição aceitável, por exemplo, menos de um minuto.

Como solicitar cota diária adicional

Se você acha que seu aplicativo precisa de uma cota diária adicional, pode solicitar um aumento da cota seguindo as instruções abaixo.

As instruções a seguir só se aplicam a projetos que encontraram um erro dailyLimitExceeded. As ações recomendadas para outros erros de cota são abordadas na tabela acima.

1. Acesse a API Bid Manager no Console de APIs do Google.
2. Revise suas estatísticas de uso na página Métricas para garantir que seu aplicativo esteja se comportando conforme o esperado. Preste muita atenção aos métodos que foram chamados e resolva usos inesperados ou excessivos antes de continuar.
3. Se o uso parecer normal, acesse a página Cotas, clique no ícone de edição ao lado de Consultas por dia e selecione o link "Inscrever-se para uma cota maior".

Leia as informações e siga as instruções incluídas no formulário de solicitação de cota antes de enviar uma solicitação de aumento.

Observação :o endereço de e-mail fornecido precisa ser monitorado ativamente, porque um representante poderá entrar em contato com você para coletar informações adicionais.