APIs do Analytics: automatizar leituras e alertas com acesso controlado

Marina abria o Analytics toda manhã para ver se as sessões, os pedidos e os leads da véspera estavam no padrão. Vinte minutos por dia. No dia em que ela faltou, ninguém percebeu que o evento do checkout tinha parado depois de uma atualização do tema da loja, e a Verde Vivo, a loja fictícia do curso, perdeu dois dias de dado.

O que uma pessoa confere em vinte minutos um programa confere em segundos, todo dia, inclusive no sábado, e avisa quando algo sai do padrão. O executivo precisa aprovar o que será automatizado, com qual permissão, consumindo qual cota, deixando qual registro e com quem responde pelos alertas. Este capítulo mostra como avaliar essas decisões.

Três usos: consultar relatórios, administrar configurações e perguntar por texto

A Data API lê relatórios: as mesmas dimensões e métricas da interface, tempo real e funis. A Admin API lê e altera a configuração: propriedades, fluxos, definições personalizadas, vínculos, retenção. Desde 14 de setembro de 2026 a Data API tem, em versão alpha, uma consulta por linguagem natural, que recebe uma pergunta em texto e devolve a resposta em blocos, com permissão própria de leitura. Para a equipe técnica, os nomes são o método properties.chat e o escopo analytics.chatbot.read. Alpha quer dizer formato sujeito a mudança sem aviso.

A mesma atualização de setembro trouxe outro campo nas respostas de relatório: dataTruncationReasons, que avisa quando os dados foram cortados por algum limite, com o tipo de corte, uma mensagem e as datas afetadas. Para uma automação, esse campo é tão importante quanto o número. Um alerta que lê um total cortado e não percebe o corte dispara falso alarme ou, pior, fica em silêncio quando deveria avisar.

A cota é dividida entre o relatório, a automação e o assistente

Cada consulta à Data API consome tokens da cota da propriedade, uma unidade de esforço proporcional à complexidade do pedido, sem custo em dinheiro. Os limites estão no quadro abaixo; o que importa para a gestão é que a mesma cota serve ao relatório do Data Studio, às rotinas automáticas e aos assistentes, e que a conversa por programa tem cota separada.

Segundo a documentação, a cota diária reinicia à meia-noite no horário padrão do Pacífico, às 5h de Brasília. Às 9h a cota diária já foi reiniciada, mas o saldo depende do que outros relatórios e programas consumiram, e a rotina consulta o saldo antes de rodar; o pico de risco é a manhã de fechamento, quando o relatório do Data Studio, aberto por muita gente, disputa a mesma cota da propriedade. Cada pedido da rotina pode solicitar que a resposta informe a cota consumida (o parâmetro returnPropertyQuota), e a rotina registra esse número.

O alerta diário compara com o padrão e avisa quem resolve

A rotina mais útil para uma equipe pequena é a sentinela. Todo dia, o programa lê sessões, compras e leads do último dia fechado por origem, compara com a mediana do mesmo dia da semana nas quatro semanas anteriores e avisa quando a diferença passa de um limite combinado. O último dia fechado é o que já saiu da janela de 48 horas em que os números ainda mudam; às 9h, isso é o dia de três dias atrás, e anteontem entra só como leitura preliminar, marcada assim no aviso. O aviso vai para o canal da equipe com o número, a referência, o link do relatório e o nome de quem investiga.

A segunda rotina é a auditoria semanal pela Admin API. Ela lista dimensões personalizadas, eventos principais, fluxos e vínculos e compara com o dicionário de dados da empresa. Diferença vira aviso: uma dimensão criada fora do dicionário, um evento principal desmarcado, um vínculo novo com uma conta de anúncios desconhecida. A Admin API também escreve, e desde 18 de junho de 2026 altera até a identidade usada nos relatórios; escrita por programa exige credencial própria e registro de quem pediu, quando e por quê.

Credencial de leitura para quem lê, credencial de escrita para quem altera

Um programa entra no Analytics com uma identidade. A conta de serviço é uma identidade do próprio projeto no Google Cloud, sem pessoa por trás, e recebe na propriedade o papel de Leitor quando só precisa ler. Quem ganha papel de Editor pode apagar uma dimensão ou desmarcar um evento principal, e o histórico de alterações mostrará o nome da conta de serviço, não de quem pediu. Por isso leitura e escrita ficam em credenciais diferentes, com donos diferentes.

O mesmo vale para assistentes de IA conectados ao Analytics. O servidor MCP oficial do Google (MCP é o padrão que permite a um assistente chamar ferramentas externas) é descrito na documentação como só de leitura. Em 22 de outubro de 2026, a versão 0.8.0 do repositório acrescentou uma ferramenta que cria anotações na propriedade, que só funciona com uma opção explícita de escrita e com a permissão de edição na credencial. Sem essas duas coisas ligadas de propósito, o servidor continua só lendo.

Na Verde Vivo, três de quatro alertas pediram correção

A rotina sentinela roda com uma conta de serviço em Leitor, consome cerca de 9.000 tokens por dia dos 200.000 da propriedade e compara doze combinações de origem e métrica. No primeiro mês ela disparou quatro alertas: o checkout parado depois da atualização do tema, um e-mail enviado sem marcação de campanha caindo em tráfego direto, um pico de visitas falsas de um domínio desconhecido e um feriado que derrubou as sessões de uma terça e não era problema. O checkout parou numa quinta à noite; o aviso preliminar chegou às 9h02 de sábado. A sentinela encurtou a descoberta de semanas para dois dias, e não substitui um monitor de interrupção em tempo real.

A auditoria semanal achou uma dimensão criada por um fornecedor fora do dicionário e um evento principal desmarcado por engano. O assistente de IA da equipe ficou ligado ao servidor MCP oficial, sem a opção de escrita, com cada consulta registrada. Para começar na sua empresa, peça à equipe uma rotina de leitura com conta de serviço em Leitor que compare o relatório de origem de anteontem com a interface; o critério de aceite tem seis itens: período e filtros equivalentes, mesma definição das métricas, total conferido, nenhum aviso de corte, cota consumida registrada e registro da execução; diferenças de processamento entre interface e API ficam identificadas e documentadas.