Cotas

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.

  1. Acesse a API Campaign Manager 360 no Console de APIs do Google.
  2. 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.
  3. 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.