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 maior.
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.000 solicitações por projeto e por dia. É possível aumentar esse número.
- Uma consulta por segundo (QPS) por projeto.
- No Console de APIs do Google, essa cota é definida como consultas por minuto por usuário e tem o valor definido como 60 por padrão. Esse limite pode ser aumentado conforme necessário, até um máximo de 600 (10 QPS).
O Criador de relatórios aplica 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 solicitação 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 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 | A mensagem | Ação recomendada |
---|---|---|---|
403 | dailyLimitExceeded | Limite diário excedido | Não tente novamente sem resolver o problema. Examine seu uso do Console de APIs do Google e modifique seu fluxo de trabalho para fazer menos solicitações. É possível solicitar cota adicional se você acredita que seu uso é razoável. |
403 | quotaExceeded | Esta conta excedeu a cota de x relatórios por dia. | Não tente gerar mais relatórios para essa conta neste dia. Entre em contato com seu gerente de conta para receber ajuda. |
403 | quotaExceeded | Este 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 neste dia. Use outro perfil de usuário ou entre em contato com seu gerente de contas para receber ajuda. |
403 | quotaExceeded | Esta conta excedeu a cota de x relatórios programados ativos. | Desative os relatórios programados que não são necessários antes de tentar fazer a 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 que desative os relatórios programados que não são necessários antes de tentar fazer a solicitação novamente. |
403 | quotaExceeded | Este 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 tentar fazer a solicitação novamente. |
403 | quotaExceeded | Não foi possível concluir esta ação porque uma das suas cotas foi excedida. Entre em contato com o gerente da conta para receber ajuda. | Entre em contato com seu gerente de 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 a taxa na qual você envia solicitações usando a retirada exponencial. Não é recomendado fazer solicitações de gravação simultâneas ou empregar um limite de taxa maior que 10 QPS com essa API. |
Como solicitar uma 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 são abordadas 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 solucione qualquer uso inesperado ou excessivo antes de continuar.
- Se o uso parecer normal, navegue até a página Cotas, clique no ícone de edição ao lado de Consultas por dia e clique no link "Inscrever-se para uma cota maior".
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.