Perguntas frequentes

Gerenciamento e aumento de cota

Eu me qualifico para um aumento de cota?
Veja como solicitar cota adicional.
Qual é a cota diária máxima para as solicitações da Google Analytics API v3?
O número máximo de consultas por segundo (QPS, na sigla em inglês) por usuário é 10, o que significa que você pode fazer até 864.000 solicitações por dia e por usuário. O número máximo de QPS por projeto é 20, o que significa que você pode fazer até 1.728.000 solicitações por dia e por projeto.
Qual é o limite máximo de aumento de cota para as solicitações de gravação da Management API?
A cota diária máxima por projeto para as solicitações de gravação da Management API é 500. Normalmente, não concedemos mais de 1.000 a 2.000 solicitações de gravação por projeto e por dia. Em alguns casos, concedemos limites mais altos temporariamente. Inclua sua justificativa no formulário de solicitação de aumento de cota.
Posso fazer as solicitações da API de gerenciamento em lote para economizar cotas?
Você pode fazer as solicitações da User Permission API em lote para economizar cotas. Para outras solicitações de API, isso não é possível. Cada solicitação em um lote é contabilizada na cota diária do projeto.
Embora nosso projeto use poucas cotas da Google Analytics API, estamos nos preparando para o lançamento de um novo projeto e esperamos ter um aumento significativo de usuários. Podemos solicitar um aumento provisório de cota?
Recomendamos que faça testes de carga realistas primeiro para assegurar que você manterá uma taxa de erro baixa para solicitações frequentes da API.
A cota de solicitações da Google Analytics API que eu uso está bem abaixo da cota atual permitida do projeto. Corro o risco de perder o aumento de cota?
Nós analisamos o uso da cota de solicitações da API e revertemos os aumentos da cota quando esse uso se mantém baixo de forma consistente e por muito tempo (por exemplo, vários meses) ou caso a taxa de erro de solicitações da API aumente de modo considerável.
Tenho uma cota diária padrão de 50.000 solicitações da API. Posso solicitar 1.000.000?
O aumento máximo da cota diária é de 100%. Dessa forma, podemos aumentar sua cota diária para, no máximo, 100.000. Você poderá solicitar cota adicional à medida que a demanda do seu projeto crescer.
Recebi um e-mail informando que minha solicitação de aumento de cota foi aprovada, mas não vejo alterações. Por quê?
O aumento de cota leva até 24 horas para ser concluído. Caso esse aumento não ocorra em 48 horas, responda ao e-mail de confirmação da aprovação para nos avisar.
Há vários dias, fiz uma solicitação de aumento de cota, mas não recebi resposta. Por quê?
Caso não receba uma resposta em até 48 horas após a solicitação, verifique se você cumpre os requisitos mínimos e se preencheu o formulário de solicitação de cota corretamente antes de entrar em contato conosco.
Minha solicitação de aumento de cota foi recusada. O que posso fazer para receber uma aprovação?
Se sua solicitação de aumento de cota for recusada, corrija os problemas mencionados no e-mail de recusa. Não aumentamos sua cota quando (1) você não fornece os motivos para uso do aumento de cota solicitado e/ou (2) seu projeto tem uma taxa de erro alta.
A taxa de erro das minhas solicitações da Google Analytics API é alta. Corro o risco de perder o aumento de cota?
Muito provavelmente. Nós analisamos o uso da cota de solicitações da API e revertemos os aumentos da cota quando esse uso se mantém baixo por muito tempo (por exemplo, vários meses) ou caso a taxa de erro de solicitações da API aumente.
Independentemente da minha cota, quando faço mais de 10.000 solicitações de API por vistas (perfil), recebo a mensagem de erro dailyLimitExceeded. Por quê?
Não é possível aumentar a cota de 10.000 solicitações da API por vistas (perfil).
Quais são as cotas máximas para as solicitações da Real Time Reporting API?
50.000 solicitações por projeto e por dia e 10 QPS por endereço IP.
O que significa erro interno do servidor?
Implemente o backoff exponencial para reenviar a solicitação da API. Se a mesma solicitação sempre apresentar falha com o código de resposta 500 ou um grande número de solicitações apresentar falha com o código de resposta 500, entre em contato conosco.
Estou usando a Core Reporting API v3. Por que eu deveria migrar para a Reporting API v4 do Google Analytics?
Para usar os recursos implementados somente na v4. Além disso, a Reporting API v4 oferece um modelo de cotas mais flexível que permite um número maior de QPS do que a v3. Ela continuará evoluindo no futuro.
Posso manter o aumento das cotas para a Core Reporting API v3 e a Reporting API v4 do Google Analytics?
Não. Digamos que você tenha aumentado sua cota de solicitações da v3 para x. Se você migrar para a v4, continuará tendo o limite de x. No entanto, a cota da v3 acabará sendo revertida de volta para o valor padrão ao fim do período de transição, que dura cerca de três meses a partir do momento que a cota da API v4 é aumentada.
Por que eu preciso participar do Programa de parceiros de tecnologia do Google Analytics?
Se você participar do Programa de parceiros de tecnologia, saberemos como usa as APIs do Google Analytics e poderemos entrar em contato com seus desenvolvedores quando uma grande porcentagem das suas solicitações da API receber mensagens de erro.

Monitoramento e registro do uso das APIs

Como faço para receber mensagens de erro com códigos específicos?
A partir da Reporting API v4 do Google Analytics, você pode usar o Developer Console para ver o detalhamento das suas solicitações de API por código de erro de resposta. Atualmente, não é possível usar o Developer Console para ver os dados de solicitações individuais.
Meu aplicativo é instalado nas máquinas dos usuários finais (por exemplo, um add-on do navegador). Como faço para receber registros, solucionar erros e monitorar o uso?
Atualmente, a Google Analytics API não fornece uma forma centralizada de acessar essas informações. Por enquanto, você pode implementar o acompanhamento de eventos do Google Analytics para acompanhar seus erros de API.