As cotas protegem a infraestrutura do Google de processos automatizados que usam a API Campaign Manager 360 de maneira inadequada. Elas garantem que as ações de um desenvolvedor não afetem negativamente a comunidade de modo mais amplo.
Limites de cotas
Os limites de cota padrão a seguir são compartilhados por todos os recursos e métodos da API Campaign Manager 360.
- 50 mil solicitações diárias por projeto. É possível aumentar esse número.
- 1 consulta por segundo (QPS, na sigla em inglês) por projeto.
- No Console de APIs do Google, essa cota é definida como consultas por 100 segundos por usuário e tem o valor definido como 100 por padrão. Esse limite pode ser aumentado conforme necessário, até um máximo de 1.000 (10 QPS).
O Criador de relatórios impõe limites de cota adicionais que variam de acordo com a conta. Para saber mais, consulte este artigo da Central de Ajuda e a tabela abaixo.
Limites de cota excedentes
No caso improvável de falha da sua solicitação por exceder um limite de cota, a API retorna um código de status HTTP e motivo do erro. Além disso, o corpo da resposta 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 por limites de cota excedentes.
| Código | Motivo | Mensagem | Ação recomendada |
|---|---|---|---|
| 403 | dailyLimitExceeded | Limite diário excedido | Não tente novamente sem corrigir 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 caso você acredite que o uso é razoável. |
| 403 | quotaExceeded | Essa conta excedeu a cota de x relatórios por dia. | Não tente executar mais relatórios para essa conta nesse dia. Entre em contato com o gerente da conta para receber ajuda. |
| 403 | quotaExceeded | Esse perfil de usuário excedeu a cota de x relatórios por dia. | Não tente executar mais relatórios para esse perfil de usuário nesse dia. Alterne para outro perfil de usuário ou entre em contato com o gerente da conta para receber ajuda. |
| 403 | quotaExceeded | Essa conta excedeu a cota de x relatórios programados ativos. | Desative os relatórios programados que não são necessários antes de fazer essa solicitação novamente. |
| 403 | quotaExceeded | O perfil de usuário proprietário desse relatório excedeu a cota de x relatórios programados ativos. | Solicite ao proprietário desse relatório que desative relatórios programados que não são necessários antes de fazer essa solicitação novamente. |
| 403 | quotaExceeded | Esse perfil de usuário excedeu a cota de x relatórios programados ativos. | Desative os relatórios programados que não são necessários antes de fazer essa solicitação novamente. |
| 403 | quotaExceeded | Não foi possível concluir essa ação porque uma das suas cotas foi excedida. Entre em contato com o gerente da conta para receber ajuda. | Entre em contato com o gerente da conta para receber ajuda. |
| 403 | userRateLimitExceeded | Limite de taxa de usuário excedido | Aumente o limite por usuário no Console de APIs do Google ou diminua o ritmo do envio de solicitações usando a espera exponencial. Não é recomendado fazer solicitações de gravação simultâneas nem empregar um limite de taxa superior a 10 QPS com essa API. |
Solicitação de cota diária adicional
Se você acha que seu aplicativo precisa de uma cota diária adicional, é possível 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 estão na tabela acima.
- Acesse a API Campaign Manager 360 no Console de APIs do Google.
- Revise suas estatísticas de uso na página Métricas para garantir que seu aplicativo tenha o comportamento esperado. Preste muita atenção aos métodos que foram chamados e resolva usos inesperados ou excessivos antes de prosseguir.
- Se o uso parecer normal, acesse a página Cotas, clique no ícone de edição ao lado de Consultas por dia e clique no link "Solicitar cota adicional".
Revise 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.