O Query Streams é compatível com o Universal Analytics (UA) ou apenas com o GA4?

O Query Streams suporta apenas o Google Analytics 4 (GA4). O Google descontinuará o Universal Analytics em 1º de julho de 2024, tornando o GA4 o padrão atual. Este conector funciona com sua propriedade GA4.

Por que os dados do GA4 estão sempre um dia atrasados?

Esta é uma limitação da plataforma GA4 — o Google processa os dados analíticos com um atraso de 24 a 48 horas antes de os disponibilizar através da API. Isto afeta todas as ferramentas que leem a partir da API de dados GA4. Para dados intradiários, o GA4 oferece uma tabela intradiária separada que atualmente não é suportada pelo Query Streams.

Posso conectar várias propriedades GA4?

Sim. Adicione um conector separado para cada propriedade GA4 — cada um seleciona uma propriedade diferente na lista suspensa durante a configuração. Todas as propriedades aparecem como fontes de dados distintas, para que você possa consultar e comparar várias propriedades em uma única instrução SQL.

Posso combinar dados do GA4 com o Google Search Console na mesma consulta?

Sim. Se você tiver o GA4 e o Google Search Console conectados, poderá UNI-LOS em uma única consulta SQL — por exemplo, unindo as visualizações de página do GA4 às análises de pesquisa do GSC por URL da página para correlacionar as classificações de pesquisa com o comportamento no site.

Conecte o Google Analytics ao Google Sheets - Consulte 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

Teve alguma dúvida? É só perguntar. Aberto Suporte Em Fluxos de Consulta (menu no canto superior direito → Suporte) e envie-nos uma mensagem. Pessoas reais leem as mensagens, e "Não sei o que esta tela está pedindo" é uma pergunta perfeitamente válida.

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 Agente trabalha em conjunto com seus dados. Sua planilha fica armazenada na nuvem do Google. Abra-a em qualquer lugar e as linhas aparecerão para você.

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.

Qual computador receberá o Agente? Qualquer máquina que esteja sempre ligada e que já consiga acessar sua conta GA4. O Google Sheets pode estar em qualquer lugar.Ele é executado no seu navegador.

Conecte-o em cinco etapas

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.
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.

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 4. Need your GA4 credentials first? Open the walkthrough, then fill in:

Create your GA4 credentials (about 15 minutes)

Follow this with Google Analytics 4 open in another tab. Query Streams keeps what you create here so your Agent can use it, and only ever reads from Google Analytics 4.

Who can do this: Google Analytics: Administrator on the GA4 property or its account (needed to add the service account). Google Cloud: Owner of the project (you are Owner of any project you create), or the Create Service Accounts, Service Account Key Admin and Service Usage Admin roles on it.
Recomendado: Google Cloud service account JSON key (a .json file of type service_account), with the service account added as Viewer on the GA4 property

Antes de começar

A GA4 property. Its Property ID is a plain number. A UA- tracking ID means an old Universal Analytics property, which Google’s API can’t read.
A Google account with the Administrator role on that GA4 property. If you don’t have it, you can do the Google Cloud part (steps 1 to 13) and ask an Administrator to do steps 14 to 19.
A Google Cloud project you can manage, or permission to create one. If your company’s Google Cloud organization was created on or after May 3, 2024, Google blocks key downloads by default and your Google Cloud administrator may need to allow it (see Common problems).
The Query Streams wizard open in another tab (Data Agents → Add connector → Google Analytics 4) with your Agent online.

Steps

Open the New Project page in Google Cloud
Sign in with your Google account and open the Google Cloud New Project page.
Already have a Google Cloud project you want to use? Skip to step 3 and pick it there. The first time you open Google Cloud, Google may ask for your country and for you to accept its Terms of Service before it shows the page.
Name and create the project
In Project name, type a name such as Query Streams GA4. Leave the organization or location box as Google fills it in (No organization is fine). Click Create.
Google does not need a billing account to create the project. Creating it takes a few seconds to a minute.
Select the project
Click the project picker at the top of the page, next to the Google Cloud logo, and click your project’s name. Every Google Cloud step below happens in this project.
The most common mistake is enabling the API in one project and creating the key in another. Check the project name at the top of the page before each Google Cloud step.
Enable the Google Analytics Data API
Open the Google Analytics Data API page in the API Library. Check that your project’s name shows at the top, then click Enable.
Pick Google Analytics Data API, not Google Analytics Reporting API, which only works with old Universal Analytics properties. If the button says Manage instead of Enable, the API is already on. This one API also serves GA4’s realtime report, so there is nothing extra to enable for the realtime_active_users table.
Enable the Google Analytics Admin API (recommended)
Open the Google Analytics Admin API page in the API Library and click Enable.
Syncing doesn’t need this API. It powers the Detect button next to GA4 Property ID in the Query Streams wizard, which lists the properties the service account can see. Skip it if you will type the Property ID yourself.
Start a service account
Open the Service accounts page. From inside Google Cloud you can also open the Navigation menu (three lines, top left) and choose IAM & Admin → Service Accounts. Click + Create service account.
Already made a service account for Query Streams’ Google Search Console connector? You can use it here too: do steps 4 and 5 in its project, then go to step 14 with its email and key.
Name the service account
In Service account name, type query-streams-ga4. Google fills in Service account ID from it. The description is optional. Click Create and continue.
The ID can’t be changed later. It becomes the first part of the service account’s email address.
Skip the project roles
The next section offers roles on the project. Leave the role box empty and click Continue.
Don’t give the service account Owner, Editor or Viewer here. Its access to Google Analytics is granted inside Google Analytics in step 18. A project role does nothing in Google Analytics and only widens what the key can do in Google Cloud.
Finish creating the service account
Leave the last section (people who can use or manage the service account) empty and click Done. You are back on the Service accounts list.
Copy the service account email
In the list, find the new account. Its email looks like [email protected]. Copy it and keep it for step 17.
Copy the whole address, through .iam.gserviceaccount.com. A new service account can take a minute or more before it is usable.
Open the Keys tab
Click the service account’s email address, then click the Keys tab.
Start a new key
Click Add key, then choose Create new key.
If Google says Service account key creation is disabled, your organization blocks key downloads. See Common problems.
Download the JSON key
Choose JSON as the key type and click Create. Your browser downloads a .json file named after your project, usually into your Downloads folder.
This download happens once: Google keeps no copy, and you can’t download the file again. If you lose it, create a new key and delete the old one. Don’t choose P12. Keep the file private. Don’t email it or put it in a shared folder, because anyone who has it can read your Analytics data. Query Streams stores it for your Agent and only ever reads with it.
Open Google Analytics Admin
Open Google Analytics and click Admin (the gear icon at the bottom left). At the top of the page, check that the account and property picker shows the GA4 property you want to read.
To add users you need the Administrator role on this property or its account. If you don’t have it, send the email from step 10 to someone who does and ask them to do steps 15 to 19.
Open Property access management
Under Property settings, in the Property group, click Property access management.
Use Property access management, not Account access management. Access added at account level reaches every property in the account.
Add a user
Click the blue + button at the top right and choose Add users.
Enter the service account email
Paste the service account email from step 10 into the email box. Untick Notify new users by email.
Nobody reads that address’s inbox, so there is no point notifying it. If GA4 answers This email doesn’t match a Google Account or Failed to add user: email not found, see Common problems. Google has had a known problem with newly created service accounts since April 2026, and waiting a few hours has fixed it for many people.
Choose the Viewer role
In the role list, choose Viewer. Leave the data restrictions No Cost Metrics and No Revenue Metrics unticked.
Viewer is enough, because Query Streams only reads reports. With No Revenue Metrics ticked, Google returns 0 in every revenue column of the ecommerce_overview and transactions tables.
Add the service account
Click Add at the top right. The service account now appears in the property’s user list with the Viewer role.
Some screens label this button Create.
Copy the Property ID
Go back to Admin. Under Property settings, in the Property group, click Property details. At the top right, PROPERTY ID shows a number such as 486480978. Click the copy icon next to it.
Use this number, not the Measurement ID (which starts with G-) and not the Account ID. The same number appears in the GA4 address bar after the letter p, for example …/p486480978/….
Copy the whole key file
Open the .json file from step 13 in a plain text editor. On Windows, right-click the file and choose Open with → Notepad. On a Mac, Control-click it and choose Open With → TextEdit. Press Ctrl+A, then Ctrl+C (Cmd+A, then Cmd+C on a Mac).
Copy everything from the first { to the last }. Don’t retype or tidy any part of it. The private_key line must stay exactly as Google wrote it.

Permissions to grant

Resource	Acesso	Used for
Google Analytics property role: Viewer (Property access management)	Visualizador	Every ga4 table: traffic_overview, traffic_sources, geographic_data, page_views, user_engagement, events, ecommerce_overview, transactions and realtime_active_users. Test connection also reads the property’s field list with it.
Data restriction: No Revenue Metrics	Unticked	Revenue columns in ecommerce_overview (purchase_revenue, total_revenue, average_purchase_revenue) and transactions (item_revenue). When ticked, Google returns 0 in them.
Data restriction: No Cost Metrics	Unticked (recommended)	No current Query Streams table reads cost metrics, so this one does no harm today. Leaving it unticked keeps any cost data readable.
Google Cloud API: Google Analytics Data API	Enabled	Every ga4 table and Test connection. The realtime report behind realtime_active_users is part of the same API.
Google Cloud API: Google Analytics Admin API	Enabled (optional)	Only the Detect button next to GA4 Property ID, which lists the properties the service account can see. No table reads it.
Google Cloud project role for the service account	Nenhum	Not needed for any table. Google Analytics access comes only from the Viewer role above.
OAuth scope https://www.googleapis.com/auth/analytics.readonly	Requested by the Agent (nothing for you to set)	Every ga4 table, Test connection and Detect. It is Google’s read-only Analytics scope, so the key can’t change anything in Google Analytics.

Paste into Query Streams

Chave JSON da conta de serviço: The whole contents of the .json file you copied in step 21, from the first { to the last }. When you edit a connector later, leave this box blank to keep the stored key, or paste a whole new file to replace it.
ID da propriedade GA4: The number you copied in step 20, digits only (for example 486480978). Or click Detect next to the box and pick your property from the list. Detect needs the Admin API from step 5 and an Agent that is online.

Common problems

Test connection fails with Invalid key type. Expected ‘service_account’.

Why: The pasted file is not a service account key. Usually it is an OAuth client file (named like client_secret_….json) or an API key from APIs & Services → Credentials.

Fix: Create a JSON key on the service account (steps 11 to 13) and paste that file. A service account key contains the line “type”: “service_account”.

Test connection fails with Invalid JSON format, or with Missing or empty ‘private_key’ field.

Why: Only part of the file was copied, or the text was changed while copying.

Fix: Open the file again in Notepad or TextEdit, press Ctrl+A (Cmd+A on a Mac), copy, and paste it into Service Account JSON Key with nothing before or after it.

Test connection fails with Forbidden – User does not have sufficient permissions for this property.

Why: The service account was not added to this property, was added to a different property, or the Property ID belongs to another property. It also happens for a few minutes right after you add the service account.

Fix: Open the property whose Property details show the same Property ID and check that the service account email is listed in Property access management with Viewer (steps 14 to 19). Wait 5 to 10 minutes, then click Test again.

Test connection fails with a Forbidden message saying Google Analytics Data API has not been used in project … before or it is disabled.

Why: The Data API is not enabled in the Google Cloud project the key belongs to. The project is named in the key file’s project_id line.

Fix: Select that project in Google Cloud, enable Google Analytics Data API (step 4), wait a few minutes, and click Test again.

Test connection fails with Invalid Property ID format: ‘G-…’. Should be numeric, or with Property ‘…’ not found.

Why: The Measurement ID (G-…), an old UA- tracking ID, or a mistyped number was entered instead of the Property ID.

Fix: Copy the number shown under PROPERTY ID on the Property details page (step 20) and paste it into GA4 Property ID.

Google Analytics won’t accept the service account email: This email doesn’t match a Google Account, or Failed to add user: email not found.

Why: A known Google problem: since late April 2026, GA4 and Search Console sometimes don’t recognise newly created service accounts for a while. Reports continued into September 2026. A typo or a space in the address causes the same message.

Fix: Paste the address again with no spaces. If it is still refused, wait a few hours and try again. A service account created earlier usually works, so if you have one, create a new key for it (steps 11 to 13) and add that email instead. An administrator who is comfortable with Google’s API Explorer can also add the service account with the Admin API’s accessBindings.create method and the role predefinedRoles/viewer.

Google Cloud shows Service account key creation is disabled when you click Create new key.

Why: Your organization enforces the policy iam.disableServiceAccountKeyCreation. Google turns it on by default for organizations created on or after May 3, 2024.

Fix: Ask your Google Cloud administrator (someone with the Organization Policy Administrator role) to allow key creation for this project or service account. Google documents a tag-based exemption for one project or service account. Then repeat steps 12 and 13.

Detect says No GA4 properties found, or reports that the Google Analytics Admin API has not been used in the project.

Why: The Admin API is not enabled (step 5), or the service account has not been added to any property yet.

Fix: Enable the Admin API and finish steps 14 to 19, then click Detect again. You can always type the Property ID yourself instead.

The ecommerce_overview and transactions tables sync, but every revenue column is 0.

Why: The service account was added with the No Revenue Metrics data restriction.

Fix: In Property access management, open the service account’s entry, untick No Revenue Metrics and save. The next sync reads the real values.

A connector that used to work stops syncing, with an error that mentions invalid_grant or Invalid JWT Signature.

Why: The key was deleted or disabled in Google Cloud. Google also disables keys it finds exposed in public.

Fix: Create a new key (steps 11 to 13). In Query Streams, open the connector in Data Agents, click Edit, paste the whole new file into Service Account JSON Key, click Test connection, then click Save changes. Delete the old key in Google Cloud.

Syncs fail with 429 or RESOURCE_EXHAUSTED.

Why: The property used up its Google Analytics API quota. Every app that reads this property through the API draws on the same per-property quota.

Fix: Wait: hourly quota refills within an hour, and daily quota resets at midnight Pacific Time. Turn off tables you don’t use, or sync them less often.

You want Query Streams to stop reading this property.

Why: Deleting the connector does not remove Google’s access. The service account stays a Viewer and the key stays valid.

Fix: In Property access management, remove the service account. In Google Cloud, open the service account’s Keys tab and delete the key. Then delete the connector in Data Agents.

Limits to know

Data freshness: GA4 can take 24 to 48 hours to finish processing a day, and figures for recent days can change after that. Each sync of the daily tables re-reads the last 3 days, so late numbers fill in on their own. Realtime data arrives within minutes.
Realtime window: GA4’s realtime report covers only the last 30 minutes (60 minutes on Analytics 360). The realtime_active_users table is a snapshot that each refresh replaces (every 5 minutes by default), not a history. It uses the same API, key and Viewer access as the other tables, with its own separate Realtime quota.
API quota for a standard property: 200,000 tokens per day and 40,000 per hour for the whole property, 14,000 per hour from one Google Cloud project, and 10 requests at a time. Most requests cost 10 tokens or fewer. Analytics 360 properties get 10 times these limits. Daily quota resets at midnight Pacific Time.
History: the first sync asks for everything since October 2020, when GA4 launched. Google returns data only from when your property started collecting. Universal Analytics (UA-) properties can’t be read through this API.
One property per connector: the Property ID selects one GA4 property. To read another property, add the same service account to it as Viewer and create a second connector. The same key works for both.
Keys: a service account key never expires unless your organization sets a maximum lifetime. Each service account can have up to 10 keys, and the key file can be downloaded only once.
Data restrictions: if the service account has No Revenue Metrics or No Cost Metrics, Google returns 0 for those metrics instead of an 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? Usually a missing permission, or a credential from the wrong GA4 account. The walkthrough above lists the common problems and their fixes.

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.
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? Em vez disso, crie a consulta no portal Query Streams. Construtor de consultas Exibe suas tabelas e colunas para que você possa apontar e clicar. Nos planos Business, você também pode usar o Nova em linguagem natural ("mostre-me os clientes nos EUA") e ele gera o SQL para você. Salve a consulta e ela estará a um clique de distância no portal e na lista de Consultas Salvas do complemento, a partir do plano Personal Core.

É isso. Seus dados estão na planilha e permanecem atualizados com um clique. Nada saiu da sua rede, exceto as linhas que você solicitou.

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

A minha conta GA4 precisa estar no mesmo computador em que uso o Planilhas Google?

Não. Apenas o agente precisa estar onde sua conta do GA4 está instalada. O Google Sheets funciona no seu navegador em qualquer dispositivo. Abra o complemento com a mesma conta do Google e suas conexões estarão lá.

Meus dados são copiados para o Query Streams?

Não. O agente executa a consulta no local onde seus dados estão armazenados e envia apenas as linhas retornadas. Nada é sincronizado ou armazenado nesse meio tempo.

O plano gratuito realmente cobre isso?

Sim. A versão gratuita é um plano permanente, não um período de teste com prazo de validade. Veja exatamente o que está incluído no plano. página de preços.

A planilha atualiza sozinha?

Clique em Executar Consulta novamente sempre que desejar as linhas mais recentes. Para uma planilha que seja atualizada automaticamente, sem que ninguém precise fazer nada, configure uma Automação no portal do Query Streams (Streams → Automação). Ela está disponível em todos os planos.

Ainda com dificuldades? Aberto Suporte Em Fluxos de Consulta, informe-nos em qual etapa você está e o que você vê. Nós o conectaremos.

Crie sua conta do plano gratuito.Veja o que está incluído na versão gratuita.

O Query Streams também conecta os mesmos dados aExcel Claude, Cursor e ChatGPT uma API REST e mais

Todos os guias para GA4

Não é bem a sua configuração?

Quer saber quais pesquisas do Google trazem pessoas para o seu site, com cliques e impressões? O Google Search Console tem esses dados → Search Console