Como conectar o Google Analytics ao Planilhas Google - Consultar o Web Analytics com SQL

Conectar o GA4 ao Google Sheets

Obtenha dados de GA4 em Planilhas Google

Importe linhas em tempo real da sua conta do GA4 para o Google Sheets e atualize-as quando quiser. Sem uploads de CSV, sem Apps Script, sem copiar e colar. Leva cerca de dez minutos na primeira vez, e o plano gratuito cobre isso.

Cerca de 10 minutos Não é necessário programar As credenciais permanecem com você. Qualquer navegador, qualquer dispositivo

O resultado final será o que você obterá.

Uma planilha do Google que exibe os resultados em tempo real de uma consulta SQL na sua conta do GA4, com um botão que busca as linhas mais recentes sempre que os dados forem alterados. Assim:

Vendas Salvo no Drive

ArquivoEditarVisualizarInserirFormatarDadosFerramentasExtensõesAjuda

	A	B	C	D	E
1	ID do cliente	primeiro nome	sobrenome	país	total
2	1042	Maria	Álvarez	EUA	1,284.50
3	1043	Daniel	Okafor	EUA	612.00
4	1047	Priya	Nair	EUA	2,090.75
5	1051	Thomas	Berg	EUA	338.20
6	1056	Lúcia	Ferreira	EUA	1,455.00
7	1060	Kenji	Sato	EUA	874.10
8

+ clientes Folha1 Ao vivo do GA4

O Google Analytics 4 armazena seus dados por trás de sua API. Para importá-los para o Google Sheets, geralmente é necessário exportar um arquivo CSV do painel do GA4 sempre que precisar de novos números. O Query Streams elimina essa necessidade: um pequeno programa auxiliar, chamado Agente, executa a consulta no local onde seus dados estão armazenados, e um complemento do Google Sheets solicita as linhas desejadas. Somente os resultados são transmitidos por meio de uma conexão criptografada, e o Google Sheets pode ser acessado de qualquer lugar: em qualquer navegador e em qualquer dispositivo.

O que você vai precisar

Uma conta do Query Streams

O plano gratuito é suficiente para este guia. Cadastre-se em my.querystreams.com.

O Agente em qualquer computador sempre ligado

Um pequeno programa que roda em segundo plano e chama o GA4 quando o Google Sheets solicita. Ele só precisa de acesso à internet.

Seu login GA4

Você fará login no GA4 uma única vez e concederá acesso de leitura. Nenhuma senha é digitada nos Fluxos de Consulta.

Conecte-o em cinco etapas

1. Crie sua conta

   Vá para my.querystreams.com e inscreva-se. Escolha o Gratuito plano. É um plano real, não uma versão de teste, e inclui a conexão da sua conta GA4 e a execução de consultas a partir do Google Sheets.

2. Instale o Agente em qualquer computador que esteja sempre ligado.

   Faça login e abra DownloadInstale o Agente em qualquer computador ou servidor que esteja sempre ligado e com acesso à internet. Leva apenas um minuto e, a partir daí, ele inicia automaticamente.

   Por que um programa pequeno em vez de um driver? O Agente é um único instalador para Windows, Mac ou Linux (cerca de 85 MB no Windows, um pouco mais de 100 MB no Mac e Linux) que funciona silenciosamente em segundo plano. Ele estabelece uma única conexão de saída criptografada com o Query Streams, da mesma forma que um navegador, portanto, você não precisa abrir nenhuma porta de firewall nem configurar uma VPN. Suas chaves permanecem nessa máquina e as linhas são enviadas para onde você estiver, pela internet, se necessário. A única coisa do seu lado é o complemento.

   A página de download mostra Sua chave de acessoCole o código no Agente quando solicitado e aguarde até que o crachá exiba a mensagem. Conectado a fluxos de consultaEssa é a única coisa que você faz no próprio Agente.

   Guias completos, se você quiser: Janelas, Mac, Linux.

3. Aponte para sua conta GA4.

   De volta ao seu navegador, abra Agentes de dados (sob Dados (no menu superior). Seu agente está listado lá. Clique Adicionar conector e escolha Google Analytics 4Precisa das suas credenciais GA4 primeiro? Abra o guia passo a passo e preencha o formulário:

   Crie suas credenciais GA4 (cerca de 15 minutos)

   Em seguida, abra o Google Analytics 4 em outra aba. O Query Streams armazena o que você cria aqui para que seu agente possa usar, e lê apenas do Google Analytics 4.

   Quem pode fazer isso?

   Google Analytics: Administrador da propriedade GA4 ou da respectiva conta (necessário para adicionar a conta de serviço). Google Cloud: Proprietário do projeto (você é o proprietário de qualquer projeto que criar) ou possui as funções de Criar Contas de Serviço, Administrador de Chaves de Conta de Serviço e Administrador de Uso de Serviço.

   Recomendado

   Chave JSON da conta de serviço do Google Cloud (um arquivo .json do tipo service_account), com a conta de serviço adicionada como Visualizador na propriedade do GA4.

   Antes de começar

   • Uma propriedade GA4. Seu ID de propriedade é um número simples. Um ID de rastreamento UA- significa uma propriedade antiga do Universal Analytics, que a API do Google não consegue ler.
   • Uma conta do Google com a função de Administrador nessa propriedade do GA4. Se você não tiver uma, pode realizar a parte do Google Cloud (etapas 1 a 13) e pedir a um Administrador que realize as etapas 14 a 19.
   • Um projeto do Google Cloud que você possa gerenciar ou permissão para criar um. Se a organização do Google Cloud da sua empresa foi criada em ou após 3 de maio de 2024, o Google bloqueia o download de chaves por padrão e o administrador do Google Cloud pode precisar permitir o acesso (consulte Problemas comuns).
   • O assistente de fluxos de consultas será aberto em outra guia (Agentes de dados → Adicionar conector → Google Analytics 4) com seu agente online.

   Passos

   1. Abra a página Novo projeto no Google Cloud.

      Faça login com sua conta do Google e abra a página Novo projeto do Google Cloud.

      Já tem um projeto do Google Cloud que deseja usar? Pule para a etapa 3 e selecione-o lá. Na primeira vez que você acessar o Google Cloud, o Google poderá solicitar seu país e que você aceite os Termos de Serviço antes de exibir a página.

   2. Dê um nome e crie o projeto.

      No campo Nome do projeto, digite um nome como "Fluxos de consulta GA4". Deixe o campo Organização ou local como o Google preenche automaticamente (nenhuma organização é suficiente). Clique em Criar.

      O Google não exige uma conta de faturamento para criar o projeto. A criação leva de alguns segundos a um minuto.

   3. Selecione o projeto

      Clique no seletor de projetos na parte superior da página, ao lado do logotipo do Google Cloud, e clique no nome do seu projeto. Todas as etapas do Google Cloud descritas abaixo ocorrem neste projeto.

      O erro mais comum é habilitar a API em um projeto e criar a chave em outro. Verifique o nome do projeto na parte superior da página antes de cada etapa no Google Cloud.

   4. Ative a API de dados do Google Analytics.

      Abra a página da API de Dados do Google Analytics na Biblioteca de APIs. Verifique se o nome do seu projeto aparece na parte superior e clique em Ativar.

      Selecione a API de Dados do Google Analytics, e não a API de Relatórios do Google Analytics, que funciona apenas com propriedades antigas do Universal Analytics. Se o botão exibir "Gerenciar" em vez de "Ativar", a API já está ativada. Essa API também fornece o relatório em tempo real do GA4, portanto, não é necessário ativar nada adicional para a tabela realtime_active_users.

   5. Ative a API de administrador do Google Analytics (recomendado)

      Abra a página da API de administração do Google Analytics na Biblioteca de APIs e clique em Ativar.

      A sincronização não precisa desta API. Ela alimenta o botão "Detectar" ao lado de "ID da propriedade GA4" no assistente de fluxos de consulta, que lista as propriedades que a conta de serviço pode visualizar. Ignore esta etapa se você for digitar o ID da propriedade manualmente.

   6. Inicie uma conta de serviço

      Abra a página Contas de serviço. No Google Cloud, você também pode abrir o menu de navegação (três linhas, canto superior esquerdo) e selecionar IAM e administração → Contas de serviço. Clique em + Criar conta de serviço.

      Já criou uma conta de serviço para o conector do Google Search Console do Query Streams? Você também pode usá-la aqui: execute os passos 4 e 5 no projeto dela e, em seguida, vá para o passo 14 com o e-mail e a chave.

   7. Dê um nome à conta de serviço.

      Em Nome da conta de serviço, digite query-streams-ga4. O Google preencherá o ID da conta de serviço com base nesse valor. A descrição é opcional. Clique em Criar e continuar.

      O ID não poderá ser alterado posteriormente. Ele se tornará a primeira parte do endereço de e-mail da conta de serviço.

   8. Ignore as funções do projeto

      A próxima seção oferece as funções no projeto. Deixe o campo de função vazio e clique em Continuar.

      Não atribua as funções de Proprietário, Editor ou Visualizador à conta de serviço aqui. O acesso ao Google Analytics é concedido dentro do próprio Google Analytics, na etapa 18. Uma função de projeto não tem efeito no Google Analytics e apenas amplia as possibilidades da chave no Google Cloud.

   9. Finalize a criação da conta de serviço.

      Deixe a última seção (pessoas que podem usar ou gerenciar a conta de serviço) em branco e clique em Concluído. Você retornará à lista de contas de serviço.

   10. Copie o e-mail da conta de serviço.

       Na lista, encontre a nova conta. O endereço de e-mail dela é semelhante a [email protected]. Copie-o e guarde-o para a etapa 17.

       Copie o endereço completo, através do .iam.gserviceaccount.com. A criação de uma nova conta de serviço pode levar um minuto ou mais para ficar pronta.

   11. Abra a aba Teclas

       Clique no endereço de e-mail da conta de serviço e, em seguida, clique na guia Chaves.

   12. Iniciar uma nova chave

       Clique em Adicionar chave e, em seguida, escolha Criar nova chave.

       Se o Google indicar que a criação de chaves de conta de serviço está desativada, sua organização bloqueará o download de chaves. Consulte Problemas comuns.

   13. Baixe a chave JSON

       Escolha JSON como tipo de chave e clique em Criar. Seu navegador fará o download de um arquivo .json com o nome do seu projeto, geralmente na pasta Downloads.

       Este download ocorre apenas uma vez: o Google não guarda nenhuma cópia e você não poderá baixar o arquivo novamente. Se você o perder, crie uma nova chave e exclua a antiga. Não escolha P12. Mantenha o arquivo privado. Não o envie por e-mail nem o coloque em uma pasta compartilhada, pois qualquer pessoa que o tenha poderá ler seus dados do Google Analytics. O Query Streams o armazena para o seu agente e só o lê por meio dele.

   14. Abra o painel de administração do Google Analytics.

       Abra o Google Analytics e clique em Administrador (o ícone de engrenagem no canto inferior esquerdo). Na parte superior da página, verifique se o seletor de conta e propriedade exibe a propriedade do GA4 que você deseja analisar.

       Para adicionar usuários, você precisa da função de Administrador nesta propriedade ou na conta associada. Caso não a possua, envie o e-mail da etapa 10 para alguém que a tenha e peça que execute as etapas 15 a 19.

   15. Gestão de acesso à propriedade aberta

       Em Configurações da propriedade, no grupo Propriedade, clique em Gerenciamento de acesso à propriedade.

       Use o gerenciamento de acesso à propriedade, não o gerenciamento de acesso à conta. O acesso adicionado no nível da conta abrange todas as propriedades da conta.

   16. Adicionar um usuário

       Clique no botão azul + no canto superior direito e selecione Adicionar usuários.

   17. Insira o e-mail da conta de serviço.

       Cole o endereço de e-mail da conta de serviço obtido na etapa 10 na caixa de e-mail. Desmarque a opção "Notificar novos usuários por e-mail".

       Ninguém lê a caixa de entrada desse endereço, então não faz sentido notificá-lo. Se o GA4 responder "Este e-mail não corresponde a uma Conta do Google" ou "Falha ao adicionar usuário: e-mail não encontrado", consulte Problemas comuns. O Google tem um problema conhecido com contas de serviço recém-criadas desde abril de 2026, e esperar algumas horas resolveu o problema para muitas pessoas.

   18. Selecione a função de espectador.

       Na lista de funções, selecione Visualizador. Deixe as restrições de dados "Sem métricas de custo" e "Sem métricas de receita" desmarcadas.

       O visualizador é suficiente, pois o Query Streams apenas lê relatórios. Com a opção "Sem métricas de receita" desmarcada, o Google retorna 0 em todas as colunas de receita das tabelas ecommerce_overview e transactions.

   19. Adicione a conta de serviço.

       Clique em Adicionar no canto superior direito. A conta de serviço agora aparece na lista de usuários da propriedade com a função de Visualizador.

       Algumas telas exibem a etiqueta "Criar" para este botão.

   20. Copie o ID da propriedade.

       Volte para Administração. Em Configurações da propriedade, no grupo Propriedade, clique em Detalhes da propriedade. No canto superior direito, o ID da propriedade exibe um número, como 486480978. Clique no ícone de copiar ao lado dele.

       Use este número, não o ID da Medição (que começa com G-) e nem o ID da Conta. O mesmo número aparece na barra de endereço do GA4 após a letra p, por exemplo …/p486480978/….

   21. Copie todo o arquivo de chave.

       Abra o arquivo .json da etapa 13 em um editor de texto simples. No Windows, clique com o botão direito do mouse no arquivo e escolha Abrir com → Bloco de Notas. No Mac, clique com a tecla Control pressionada e escolha Abrir com → TextEdit. Pressione Ctrl+A e, em seguida, Ctrl+C (Cmd+A e, em seguida, Cmd+C no Mac).

       Copie tudo do primeiro { ao último }. Não digite novamente nem altere nenhuma parte. A linha private_key deve permanecer exatamente como o Google a escreveu.

   Permissões a conceder

   Recurso	Acesso	Usado para
   Função da propriedade no Google Analytics: Visualizador (Gestão de acesso à propriedade)	Visualizador	Todas as tabelas do GA4: traffic_overview, traffic_sources, geographic_data, page_views, user_engagement, events, ecommerce_overview, transactions e realtime_active_users. O teste de conexão também lê a lista de campos da propriedade.
   Restrição de dados: Sem métricas de receita	Desmarcado	As colunas de receita em ecommerce_overview (purchase_revenue, total_revenue, average_purchase_revenue) e transações (item_revenue) são exibidas. Quando marcadas, o Google retorna 0 em cada uma delas.
   Restrição de dados: Sem métricas de custo	Desmarcado (recomendado)	Nenhuma tabela do Query Streams lê métricas de custo atualmente, então esta opção não causa nenhum problema. Deixá-la desmarcada mantém os dados de custo legíveis.
   API do Google Cloud: API de dados do Google Analytics	Habilitado	Cada tabela ga4 e conexão de teste. O relatório em tempo real por trás de realtime_active_users faz parte da mesma API.
   API do Google Cloud: API de administração do Google Analytics	Ativado (opcional)	Apenas o botão Detectar ao lado do ID da propriedade GA4 lista as propriedades que a conta de serviço pode visualizar. Nenhuma tabela lê essa informação.
   Função do projeto do Google Cloud para a conta de serviço	Nenhum	Não é necessário para nenhuma tabela. O acesso ao Google Analytics é concedido apenas pela função de Visualizador acima.
   Escopo OAuth: https://www.googleapis.com/auth/analytics.readonly	Solicitado pelo agente (nada que você precise configurar)	Cada tabela ga4, Teste de conexão e Detecção. É um escopo de análise somente leitura do Google, portanto, a chave não pode alterar nada no Google Analytics.

   Colar em Fluxos de Consulta

   Chave JSON da conta de serviço

   Todo o conteúdo do arquivo .json que você copiou na etapa 21, do primeiro { ao último }. Ao editar um conector posteriormente, deixe este campo em branco para manter a chave armazenada ou cole um arquivo completamente novo para substituí-la.

   ID da propriedade GA4

   O número que você copiou na etapa 20, somente dígitos (por exemplo, 486480978). Ou clique em Detectar ao lado da caixa e selecione sua propriedade na lista. A função Detectar requer a API de Administração da etapa 5 e um Agente online.

   Problemas comuns

   O teste de conexão falhou com a mensagem "Tipo de chave inválido. Esperava-se 'service_account'".

   Por que: O arquivo colado não é uma chave de conta de serviço. Normalmente, trata-se de um arquivo de cliente OAuth (com um nome como client_secret_….json) ou uma chave de API obtida em APIs e Serviços → Credenciais.

   Consertar: Crie uma chave JSON na conta de serviço (passos 11 a 13) e cole esse arquivo. Uma chave de conta de serviço contém a linha “type”: “service_account”.

   O teste de conexão falha com o formato JSON inválido ou com o campo 'private_key' ausente ou vazio.

   Por que: Apenas parte do arquivo foi copiada, ou o texto foi alterado durante a cópia.

   Consertar: Abra o arquivo novamente no Bloco de Notas ou TextEdit, pressione Ctrl+A (Cmd+A no Mac), copie e cole o conteúdo no campo "Chave JSON da Conta de Serviço", sem nada antes ou depois.

   O teste de conexão falhou com a mensagem "Proibido – O usuário não possui permissões suficientes para esta propriedade".

   Por que: A conta de serviço não foi adicionada a esta propriedade, foi adicionada a uma propriedade diferente ou o ID da propriedade pertence a outra propriedade. Isso também ocorre por alguns minutos logo após a adição da conta de serviço.

   Consertar: Abra o imóvel cujos detalhes mostram o mesmo ID e verifique se o e-mail da conta de serviço está listado no gerenciamento de acesso ao imóvel com o Viewer (etapas 14 a 19). Aguarde de 5 a 10 minutos e clique em Testar novamente.

   O teste de conexão falha com uma mensagem de "Proibido" informando que a API de dados do Google Analytics não foi usada anteriormente no projeto … ou está desativada.

   Por que: A API de Dados não está habilitada no projeto do Google Cloud ao qual a chave pertence. O projeto está nomeado na linha `project_id` do arquivo de chave.

   Consertar: Selecione esse projeto no Google Cloud, ative a API de dados do Google Analytics (etapa 4), aguarde alguns minutos e clique em Testar novamente.

   O teste de conexão falhou com o erro "Formato de ID de propriedade inválido: 'G-…'. Deve ser numérico" ou com "Propriedade '…' não encontrada".

   Por que: O ID de medição (G-…), um ID de rastreamento UA antigo ou um número digitado incorretamente foi inserido em vez do ID da propriedade.

   Consertar: Copie o número exibido em ID DA PROPRIEDADE na página de detalhes da propriedade (etapa 20) e cole-o em ID da propriedade no GA4.

   O Google Analytics não aceita o e-mail da conta de serviço: Este e-mail não corresponde a uma Conta do Google ou Falha ao adicionar usuário: e-mail não encontrado.

   Por que: Um problema conhecido do Google: desde o final de abril de 2026, o GA4 e o Search Console às vezes não reconhecem contas de serviço recém-criadas por um período. Os relatos continuaram até setembro de 2026. Um erro de digitação ou um espaço no endereço causa a mesma mensagem.

   Consertar: Cole o endereço novamente, sem espaços. Se ainda assim for recusado, aguarde algumas horas e tente novamente. Uma conta de serviço criada anteriormente geralmente funciona; portanto, se você tiver uma, crie uma nova chave para ela (passos 11 a 13) e adicione esse e-mail. Um administrador familiarizado com o Explorador de APIs do Google também pode adicionar a conta de serviço usando o método `accessBindings.create` da API de administração e a função `predefinedRoles/viewer`.

   O Google Cloud exibe a mensagem "A criação de chaves de conta de serviço está desativada" ao clicar em "Criar nova chave".

   Por que: Sua organização aplica a política iam.disableServiceAccountKeyCreation. O Google a ativa por padrão para organizações criadas a partir de 3 de maio de 2024.

   Consertar: Peça ao administrador do Google Cloud (alguém com a função de Administrador de Políticas da Organização) para permitir a criação de chaves para este projeto ou conta de serviço. O Google documenta uma exceção baseada em tags para um projeto ou conta de serviço. Em seguida, repita os passos 12 e 13.

   O Detect indica que nenhuma propriedade do GA4 foi encontrada ou relata que a API de administração do Google Analytics não foi usada no projeto.

   Por que: A API de administração não está habilitada (etapa 5) ou a conta de serviço ainda não foi adicionada a nenhuma propriedade.

   Consertar: Ative a API de administração e conclua as etapas de 14 a 19. Em seguida, clique em Detectar novamente. Você também pode digitar o ID da propriedade manualmente.

   As tabelas ecommerce_overview e transactions estão sincronizadas, mas todas as colunas de receita estão zeradas.

   Por que: A conta de serviço foi adicionada com a restrição de dados "Sem métricas de receita".

   Consertar: Em Gerenciamento de acesso à propriedade, abra a entrada da conta de serviço, desmarque a opção Sem métricas de receita e salve. A próxima sincronização exibirá os valores reais.

   Um conector que funcionava normalmente parou de sincronizar, apresentando um erro que menciona invalid_grant ou assinatura JWT inválida.

   Por que: A chave foi excluída ou desativada no Google Cloud. O Google também desativa chaves que encontra expostas publicamente.

   Consertar: Crie uma nova chave (passos 11 a 13). No Query Streams, abra o conector em Agentes de Dados, clique em Editar, cole todo o novo arquivo em Chave JSON da Conta de Serviço, clique em Testar conexão e, em seguida, clique em Salvar alterações. Exclua a chave antiga no Google Cloud.

   A sincronização falha com o código 429 ou RESOURCE_EXHAUSTED.

   Por que: A propriedade esgotou sua cota da API do Google Analytics. Todos os aplicativos que leem essa propriedade por meio da API utilizam a mesma cota por propriedade.

   Consertar: Aguarde: a cota horária é recarregada em uma hora e a cota diária é zerada à meia-noite, horário do Pacífico. Desative as tabelas que você não usa ou sincronize-as com menos frequência.

   Você deseja que o Query Streams pare de ler esta propriedade.

   Por que: Excluir o conector não remove o acesso do Google. A conta de serviço permanece como Visualizador e a chave continua válida.

   Consertar: Em Gerenciamento de acesso à propriedade, remova a conta de serviço. No Google Cloud, abra a guia Chaves da conta de serviço e exclua a chave. Em seguida, exclua o conector em Agentes de dados.

   Limites do conhecimento

   • Atualização dos dados: O GA4 pode levar de 24 a 48 horas para concluir o processamento diário, e os números dos dias mais recentes podem mudar após esse período. Cada sincronização das tabelas diárias relê os últimos 3 dias, portanto, os números atrasados são preenchidos automaticamente. Os dados em tempo real chegam em poucos minutos.
   • Janela em tempo real: o relatório em tempo real do GA4 abrange apenas os últimos 30 minutos (60 minutos no Analytics 360). A tabela `realtime_active_users` é um instantâneo que é substituído a cada atualização (a cada 5 minutos por padrão), e não um histórico. Ela utiliza a mesma API, chave e acesso do Visualizador que as outras tabelas, com sua própria cota de tempo real separada.
   • Cota de API para uma propriedade padrão: 200.000 tokens por dia e 40.000 por hora para toda a propriedade, 14.000 por hora de um projeto do Google Cloud e 10 solicitações por vez. A maioria das solicitações custa 10 tokens ou menos. As propriedades do Analytics 360 têm limites 10 vezes maiores. A cota diária é redefinida à meia-noite, horário do Pacífico.
   • Histórico: a primeira sincronização solicita todos os dados desde outubro de 2020, quando o GA4 foi lançado. O Google retorna dados apenas a partir do momento em que sua propriedade começou a coletar dados. Propriedades do Universal Analytics (UA-) não podem ser lidas por meio desta API.
   • Uma propriedade por conector: o ID da propriedade seleciona uma propriedade do GA4. Para ler outra propriedade, adicione a mesma conta de serviço como Visualizador e crie um segundo conector. A mesma chave funciona para ambos.
   • Chaves: uma chave de conta de serviço nunca expira, a menos que sua organização defina um tempo de vida máximo. Cada conta de serviço pode ter até 10 chaves, e o arquivo de chave só pode ser baixado uma vez.
   • Restrições de dados: se a conta de serviço não tiver métricas de receita ou métricas de custo, o Google retornará 0 para essas métricas em vez de um erro.

   Etapas verificadas em 8 de outubro de 2026. Fontes: developers.google.com/analytics/devguides/reporting/data/v1, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/workspace/guides/create-project, docs.cloud.google.com/resource-manager/docs/creating-mana…, docs.cloud.google.com/service-usage/docs/enable-disable, docs.cloud.google.com/iam/docs/service-accounts-create, docs.cloud.google.com/iam/docs/keys-create-delete, docs.cloud.google.com/iam/docs/service-account-creds, docs.cloud.google.com/iam/docs/troubleshoot-org-policies, docs.cloud.google.com/iam/docs/best-practices-for-managin…, support.google.com/googleapi/answer/6158841?hl=en, support.google.com/analytics/answer/9305788?hl=en, support.google.com/analytics/answer/9305587?hl=en, support.google.com/analytics/answer/9304776?hl=en, support.google.com/analytics/answer/11198161?hl=en, docs.ovhcloud.com/en/guides/public-cloud/data-platform/co…, windsor.ai/documentation/how-to-connect-ga4-to-windsor-ai…, seopress.org/support/guides/find-my-google-analytics-4-pr…, analytify.io/adicionar-usuário-ao-google-analytics, optimizesmart.com/blog/google-analytics-4-measurement-id-…, discuss.google.dev/t/problem-with-new-service-accounts/36…, piunikaweb.com/2026/05/01/google-service-account-email-no…, sanj.dev/post/google-analytics-search-console-service-acc…, oneuptime.com/blog/post/2026-01-24-gcp-service-account-ke…, help.genesys.cloud/articles/data-action-returns-a-400-error.

   Nome da conexão

   Qualquer nome que você reconheça mais tarde, como Banco de Dados de Vendas.

   Chave JSON da conta de serviço

   Cole o conteúdo do arquivo de chave para uma conta de serviço do Google que foi adicionada como visualizadora em sua propriedade do GA4.

   ID da propriedade GA4

   O número que identifica sua propriedade no GA4, encontrado no painel de administração do GA4 em Configurações da propriedade, como 486480978.

   Clique em Teste de conexãoQuando lê Conectado, clique SalvarA conexão chega ao seu agente em poucos segundos.

   Agentes de Dados Abertos

   O teste falhou? Geralmente, trata-se de uma permissão ausente ou de uma credencial de uma conta GA4 incorreta. O passo a passo acima lista as problemas comuns e suas correções.

4. See your data in Query Builder Opcional

   You can look at your GA4 account before Google Sheets is involved at all. Open Construtor de consultas in the portal and pick the connection you just made. The Esquema tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click Executar and the rows appear under Resultados. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Adicionar fluxos de consulta ao Google Sheets

   Abra qualquer planilha do Google e acesse Extensões → Complementos → Obter complementos, procurar Fluxos de consultae clique InstalarOu instale-o diretamente de Consultar fluxos no Google Workspace MarketplaceO Google pedirá que você permita o complemento; isso é normal.

   Depois disso, estará presente em todas as Planilhas Google que você abrir: um ícone do Query Streams no painel lateral à direita, também listado em ExtensõesNão há necessidade de fazer login separadamente. O sistema reconhece a conta do Google que você já utiliza, portanto, o e-mail precisa ser o mesmo cadastrado na sua conta do Query Streams.

6. Puxe sua primeira mesa.

   Clique no ícone "Consultar Fluxos" no painel lateral à direita da planilha (ou encontre-o em "Acessar Fluxos"). Extensões). Escolher Fluxo de consulta e selecione a conexão que você acabou de fazer.

   Digite a consulta que deseja executar. Esta consulta extrai algumas colunas de uma tabela. ga4.visão_geral_do_tráfego mesa:

   Exemplo · SQL

   SELECT date, sessions, total_users, screen_page_views FROM ga4.traffic_overview ORDER BY date DESC LIMIT 100;

   Sob Folha de Destino Selecione a aba onde as linhas devem ser exibidas e clique em Executar consultaAs linhas aparecem nessa aba em um ou dois segundos. Clique em "Executar consulta" novamente sempre que os dados forem alterados e a aba será atualizada automaticamente.

   Não conhece SQL? Build it in Construtor de consultas first and paste it here, or pick it from Saved Queries if you saved it.

Boas próximas jogadas

• Salvar consulta no portal, para que você possa executá-lo novamente com um clique, a partir do Google Sheets ou do Excel.
• Adicionar um filtro como um intervalo de datas, para que a mesma consulta possa responder "este mês" sem precisar editar.
• Compartilhe os resultados Com um colega. Eles veem as fileiras, não suas credenciais.

Perguntas que as pessoas fazem

Guias relacionados

• Google Analytics 4 para Microsoft Excel
• Stripe para o Google Sheets
• HubSpot para Google Sheets
• Shopify para Google Sheets
• Power Query para Google Sheets
• Todos os guias