Emilytics

API GA4: Como Extrair Seus Dados Programaticamente

Emily RedmondAnalista de Dados, Emilytics18 de abril de 2026

API GA4: Como Extrair Seus Dados Programaticamente

Por Emily Redmond, Analista de Dados na Emilytics · Abril de 2026

TL;DR: A API Reporting GA4 permite extrair dados programaticamente. Construa relatórios automatizados, dashboards ou integrações sem exportações manuais.

Exportar relatórios GA4 manualmente é tedioso. A API automatiza. Extraia dados diretamente em planilhas, dashboards customizados ou seu data warehouse.

O que é a API GA4?

A API GA4 Reporting permite solicitar dados GA4 programaticamente. Em vez de:

  1. Abrir GA4
  2. Clicar por menus
  3. Exportar CSV
  4. Colar na planilha

Você escreve código (ou usa uma ferramenta) para:

  1. Solicitar dados da API GA4
  2. Obter resultados automaticamente
  3. Atualizar seu dashboard/planilha diariamente

Isso é útil para:

  • Relatórios diários automatizados: Emails enviados aos stakeholders toda manhã
  • Dashboards customizados: Dados em Sheets, Looker, Tableau
  • Integração com outras ferramentas: Envie dados GA4 para CRM, data warehouse, etc.
  • Análise de dados: Extraia dados brutos em Python/R para análise estatística

Pré-requisitos

  1. Propriedade GA4 com coleta de dados
  2. Projeto Google Cloud (gratuito)
  3. Conta de serviço com acesso à API GA4
  4. Conhecimento básico de programação (ou use uma ferramenta pré-construída como Data Studio)

Começando: Configuração de Conta de Serviço

Passo 1: Criar um Projeto Google Cloud

  1. Vá para console.cloud.google.com
  2. Crie um novo projeto (canto superior esquerdo, clique no dropdown de projeto)
  3. Nomeie (ex: "GA4 API Integration")
  4. Criar

Passo 2: Ativar a API GA4 Reporting

  1. No Google Cloud, vá para APIs & Services → Library
  2. Pesquise por "Google Analytics Reporting API"
  3. Clique nela
  4. Clique em Enable

Passo 3: Criar uma Conta de Serviço

  1. Vá para APIs & Services → Credentials
  2. Clique em Create Credentials → Service Account
  3. Preencha o nome da conta (ex: "ga4-api-reader")
  4. Criar

Passo 4: Gerar uma Chave

  1. Clique na conta de serviço que criou
  2. Vá para aba Keys
  3. Clique em Add Key → Create new key → JSON
  4. Baixe o arquivo JSON (mantenha seguro — é suas credenciais)

Passo 5: Conceder Acesso GA4

  1. Vá para sua propriedade GA4
  2. Vá para Admin → Account access management
  3. Clique em Grant Access
  4. Convide o email da conta de serviço (do arquivo JSON, parece como [email protected])
  5. Dê a ela papel "Editor" ou "Analyst"
  6. Conceder

GA4 agora confia na conta de serviço.

Usando a API: Exemplo de Código

Exemplo Python

from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import RunReportRequest

# Inicialize cliente com seu JSON de conta de serviço
client = BetaAnalyticsDataClient()

# Seu ID de propriedade GA4 (numérico, do Admin → Configurações de propriedade)
property_id = "1234567890"

# Defina o relatório
request = RunReportRequest(
    property=f"properties/{property_id}",
    date_ranges=[{"start_date": "2024-01-01", "end_date": "2024-01-31"}],
    dimensions=[{"name": "date"}, {"name": "country"}],
    metrics=[{"name": "activeUsers"}, {"name": "conversions"}],
)

# Execute o relatório
response = client.run_report(request)

# Imprima resultados
for row in response.rows:
    print(row.dimension_values, row.metric_values)

Isso extrai usuários ativos diários e conversões por país para janeiro de 2024.

Exemplo Google Sheets (Sem Código)

Se não quer codificar, use o Conector Google Analytics para Sheets:

  1. Abra Google Sheets
  2. Data → Data connectors
  3. Pesquise por "Google Analytics"
  4. Clique em Google Analytics Connector
  5. Autorize e conecte sua propriedade GA4
  6. Escolha dimensões e métricas
  7. Sheets extrai dados automaticamente e atualiza diariamente

Sem configuração de API necessária.

Consultas de API Comuns

Conversões Diárias

Data, Conversões
Propriedade: [sua propriedade GA4]
Dimensões: data
Métricas: conversões
Intervalo de data: Últimos 30 dias

Receita por Fonte de Tráfego

Fonte/Meio, Receita
Dimensões: source/medium
Métricas: receita
Intervalo de data: Últimos 7 dias

Desempenho de Página

Página, Usuários, Conversões, Taxa de Conversão
Dimensões: caminhoDaPágina
Métricas: usuáriosAtivos, conversões
Intervalo de data: Últimos 30 dias

Limites da API

  • Nível gratuito: 10.000 requisições/dia (geralmente suficiente)
  • Reporting: Até 100.000 dimensões por requisição
  • Limitação de taxa: 1.000 requisições simultâneas

Para a maioria dos negócios, você não atinge esses limites.

Ferramentas que Usam API GA4 Internamente

Você nem sempre precisa codificar. Essas ferramentas usam a API e fornecem UI:

  • Google Data Studio: Gratuito, dashboards visuais
  • Conector Google Sheets: Gratuito, integra com Sheets
  • Looker Studio: Gratuito/pago, análise avançada
  • Supermetrics: Pago, extrai GA4 em Sheets, Excel, Email
  • Ferramentas de automação: Zapier, Make, IFTTT podem disparar consultas API GA4

Para usuários não-técnicos, comece com Data Studio ou Conector Sheets.

Perguntas Frequentes

P: A API GA4 é gratuita? R: Sim, para uso razoável (a maioria das equipes fica bem abaixo do limite diário).

P: Preciso de uma conta de serviço para a API? R: Sim, para acesso automatizado. Alternativamente, você pode usar fluxo OAuth (usuário concede permissão).

P: Qual é a diferença entre API GA4 e BigQuery? R: API GA4 é bom para consultas rápidas e automação. BigQuery é melhor para análise de dados em larga escala e dados históricos.

P: Posso extrair dados em tempo real? R: API GA4 tem suporte limitado a tempo real. Para dados em tempo real, use a API Real-Time ou relatório Real-Time GA4.

P: Com que frequência devo consultar a API? R: Diariamente é típico para a maioria dos dashboards. Consultas em tempo real podem acontecer várias vezes/hora, mas fique atento aos limites de taxa.

O Resumo

API GA4 é poderosa para automação. Em vez de exportações manuais, extraia dados sob demanda. Construa dashboards que auto-atualizam. Envie relatórios diários via email.

Para a maioria das equipes, Conector Google Sheets ou Data Studio é suficiente. Sem código necessário.

Se precisa de mais controle, aprenda a API. Está bem documentada e exemplos Python/JavaScript são fáceis de encontrar.

Emily Redmond é uma analista de dados na Emilytics — o agente de análise de IA que observa seus dados de GA4, Search Console e Bing 24 horas por dia para você nunca perder o que importa. 8 anos de experiência ajudando fundadores e equipes de crescimento transformar ruído de dados em decisões claras. Diga olá →

Mais de Google Analytics 4