Obtenha dados de Console de pesquisa em Excel
Importe linhas em tempo real da sua conta do Search Console para o Excel e atualize-as quando quiser. Sem driver ODBC, sem exportações, sem macros. Leva cerca de dez minutos na primeira vez, e o plano gratuito cobre isso.
O resultado final será o que você obterá.
Uma planilha que exibe os resultados em tempo real de uma consulta SQL na sua conta do Search Console, com um botão que busca as linhas mais recentes sempre que os dados forem alterados. Assim:
Vendas.xlsx — Excel| 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 |
Ao vivo do Search ConsoleO Google Search Console armazena seus dados por meio de sua API. Para importá-los para o Excel, geralmente é necessário exportar um arquivo CSV do painel do Search Console 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 suplemento do Excel solicita as linhas desejadas. Somente os resultados são transmitidos por meio de uma conexão criptografada, e o Excel pode ser acessado de qualquer lugar: seu laptop em casa, o computador de um colega em outra cidade ou o Excel na web.
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 acessa o Search Console quando o Excel solicita. Ele só precisa de acesso à internet.
Seu login do Search Console
Você fará login no Search Console uma única vez e concederá acesso de leitura. Nenhuma senha é digitada nos Fluxos de Consulta.
Qual computador receberá o Agente? Qualquer dispositivo que esteja sempre ligado e que já consiga acessar sua conta do Search Console. O Excel pode estar em qualquer lugar., incluindo o Excel na web.
Conecte-o em cinco etapas
-
Crie sua conta
Vá para my.querystreams.com e inscreva-se. Escolha o Gratuito É um plano real, não uma versão de avaliação, e inclui a conexão da sua conta do Search Console e a execução de consultas a partir do Excel.
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.
-
Aponte para sua conta do Search Console.
De volta ao seu navegador, abra Agentes de dados (sob Dados (no menu superior). Seu agente está listado lá. Clique Adicionar conector e escolha Console de pesquisa do GooglePrecisa das suas credenciais do Search Console primeiro? Abra o passo a passo e preencha os campos:
Crie suas credenciais do Search Console (cerca de 15 minutos)
Em seguida, abra o Google Search Console em outra aba. O Query Streams armazena as informações criadas aqui para que seu agente possa utilizá-las, e lê apenas do Google Search Console.
- Quem pode fazer isso?
- Search Console: Proprietário (verificado ou delegado) da propriedade, para adicionar a conta de serviço como um usuário. Google Cloud: Proprietário do projeto (você obtém a função de Proprietário em qualquer projeto que criar) ou 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 um usuário restrito na propriedade do Search Console.
Antes de começar
- Seu site já foi adicionado e verificado no Google Search Console. Uma propriedade totalmente nova pode levar até uma semana para que o Google tenha dados sobre ela.
- Acesso de proprietário àquela propriedade do Search Console. Somente proprietários podem adicionar usuários. Se você for um usuário com acesso completo ou restrito, poderá realizar a parte do Google Cloud (etapas 1 a 12) e pedir a um proprietário que realize as etapas 13 a 17.
- Uma conta do Google que possa criar um projeto do Google Cloud ou um projeto existente que você gerencie. 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 permiti-lo (consulte Problemas comuns).
- Não é necessária uma conta de faturamento. O Google não cobra pela API do Search Console.
- Já configurou o conector do Google Analytics 4 do Query Streams com uma conta de serviço? Você pode reutilizá-lo: habilite a API do Search Console no mesmo projeto (etapa 4) e, em seguida, vá para a etapa 13 com o e-mail dessa conta de serviço. O mesmo arquivo de chave JSON deve ser usado em ambos os conectores.
- O assistente de Fluxos de Consultas será aberto em outra guia (Agentes de dados → Adicionar conector → Google Search Console) com seu agente online.
Passos
- Abra o recurso Gerenciar recursos no Google Cloud.
Inicie sessão com a sua conta Google, abra a página Gerir recursos da consola do Google Cloud e clique em Criar projeto.
Já tem um projeto do Google Cloud que deseja usar, como aquele que você criou para o conector do Google Analytics 4? 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.
- Dê um nome e crie o projeto.
Na janela Novo projeto, digite um nome para o projeto, como "Search Console do Query Streams". Deixe o campo da organização ou pasta principal como o Google preenche automaticamente. Se nenhuma organização for sugerida, não se preocupe. Clique em Criar.
Os nomes dos projetos podem ter de 4 a 30 caracteres: letras, números, espaços, hífens, aspas simples e pontos de exclamação. Não é necessário escolher uma conta de faturamento.
- 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.
- Ative a API do Google Search Console.
Abra a página da API do Google Search Console na Biblioteca de APIs. Verifique se o nome do seu projeto aparece na parte superior e clique em Ativar.
Você também pode acessar a API em APIs e Serviços → Biblioteca: pesquise por API do Google Search Console. Não selecione a API de Indexação ou a API de Verificação de Sites, pois o Query Streams não a utiliza. Se o Google indicar que a API já está ativada, prossiga para a etapa 5. Essa API abrange tudo o que o Query Streams lê: sua lista de propriedades, sitemaps, dados de desempenho e inspeção de URLs.
- Abra a página Criar conta de serviço
Abra a página Criar conta de serviço. No Google Cloud, você também pode abrir o menu de navegação (três linhas, canto superior esquerdo), escolher IAM e administração → Contas de serviço e clicar em + Criar conta de serviço.
Vai reutilizar a conta de serviço do conector do Google Analytics 4? Não crie uma segunda. Execute o passo 4 no projeto correspondente e, em seguida, vá para o passo 13 com o e-mail utilizado.
- Dê um nome à conta de serviço.
Em Nome da conta de serviço, digite query-streams-gsc. 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.
- 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 dela aos seus dados do Search Console é concedido dentro do Search Console na etapa 16. Uma função do Google Cloud não tem nenhuma função no Search Console e apenas amplia as possibilidades da chave no Google Cloud.
- Finalize a criação da conta de serviço.
Deixe a última seção (Função de usuários da conta de serviço e Função de administradores da conta de serviço) em branco e clique em Concluído. Você retornará à lista de contas de serviço.
- 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 16.
Copie o endereço completo, incluindo .iam.gserviceaccount.com. O mesmo endereço está no arquivo de chave da etapa 12, na linha client_email. O Google informa que uma nova conta de serviço pode levar um minuto ou mais para ficar pronta para uso.
- Abra a aba Teclas
Clique no endereço de e-mail da conta de serviço e, em seguida, clique na guia Chaves.
- Iniciar uma nova chave
Clique em Adicionar chave e, em seguida, escolha Criar nova chave.
Se uma caixa intitulada "A criação de chaves de conta de serviço está desativada" for exibida, sua organização está bloqueando o download de chaves. Consulte Problemas comuns.
- Baixe a chave JSON
Escolha JSON como o tipo de chave e clique em Criar. Seu navegador fará o download de um arquivo .json, geralmente para a pasta Downloads.
Este download é feito apenas uma vez: você não poderá baixar o mesmo 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 possua poderá ler esses dados do Search Console. O Query Streams armazena os dados para o seu agente e só os lê por meio dele.
- Abra o Search Console e selecione o imóvel.
Abra o Google Search Console e faça login como proprietário do site. No menu suspenso "Propriedades", no canto superior esquerdo, selecione a propriedade que você deseja que o Query Streams leia.
Se o site estiver listado duas vezes, uma vez como nome simples (exemplo.com) e outra como endereço (https://www.exemplo.com/), o nome simples é a propriedade de domínio. Ele abrange todos os subdomínios e tanto o http quanto o https, portanto, geralmente é a opção a ser escolhida.
- Usuários e permissões abertos
No menu à esquerda, role para baixo e clique em Configurações. Em seguida, clique em Usuários e permissões.
Somente os proprietários do imóvel podem ver os usuários e as permissões. Se essa opção não estiver lá, você é um usuário com acesso total ou restrito: envie o e-mail da etapa 9 para um proprietário do imóvel e peça que ele execute as etapas 13 a 17.
- Clique em Adicionar usuário
Clique em Adicionar usuário no canto superior direito da página Usuários e permissões. A caixa Adicionar usuário será aberta.
- Insira o endereço de e-mail da conta de serviço e selecione Restrito.
Cole o endereço de e-mail da conta de serviço da etapa 9 no campo Endereço de e-mail. Abra a lista de permissões e selecione Restrito.
A permissão restrita é suficiente: o Google permite que usuários com permissão restrita visualizem todos os relatórios, incluindo o de desempenho, e usem a inspeção de URLs. A permissão completa também funciona. De qualquer forma, o agente solicita ao Google apenas acesso de leitura, portanto, não pode enviar sitemaps, remover URLs ou alterar configurações.
- Adicione a conta de serviço.
Clique em Adicionar. A conta de serviço agora aparece na lista de usuários da propriedade com permissão Restrita.
Se o Search Console não aceitar o endereço (por exemplo, se indicar que o e-mail não corresponde a uma Conta do Google ou não foi encontrado), consulte Problemas comuns. O Google tem um problema conhecido com contas de serviço recém-criadas desde abril de 2026.
- Observe como a propriedade está escrita.
Observe o nome da propriedade no menu suspenso de propriedades. Um nome simples como example.com é uma propriedade de domínio: você deve inseri-lo como sc-domain:example.com. Um endereço completo como https://www.example.com/ é uma propriedade de prefixo de URL: você deve inseri-lo exatamente como mostrado, com o mesmo http ou https, o mesmo www ou sem www e a barra no final.
Ainda mais fácil: o botão Detectar no assistente de Fluxos de Consulta lista os valores exatos para você. Digitar https://example.com/ quando a propriedade é https://www.example.com/, ou omitir a última barra, aponta para uma propriedade que a conta de serviço não consegue ler.
Permissões a conceder
Recurso Acesso Usado para Permissões de usuário do Search Console (Configurações → Usuários e permissões) Restrito (Completo também funciona) Todas as tabelas do Google Search Console (gsc): search_analytics (dados de desempenho: cliques, impressões, CTR e posição por data, consulta, página, país e dispositivo), sites e sitemaps, todas ativadas por padrão, além da inspeção de URL (desativada por padrão, executada sob demanda). O Google permite que usuários com acesso restrito visualizem todos os relatórios e usem a inspeção de URL. API do Google Cloud: API do Google Search Console Habilitado Teste a conexão, o botão Detectar e todas as tabelas gsc. Sem isso, o Google responde com o código 403 a todas as chamadas. Escopo OAuth: https://www.googleapis.com/auth/webmasters.readonly Solicitado pelo agente (nada que você precise configurar) Todas as tabelas do Google Search Console, Teste de conexão e Detecção. O Google descreve esse escopo como acesso somente leitura, portanto, o Agente não pode enviar sitemaps, remover URLs ou alterar qualquer configuração. Função do projeto do Google Cloud para a conta de serviço Nenhum Nenhuma tabela precisa de uma. O acesso ao Search Console só é possível com a permissão de usuário acima. Proprietário do Search Console (a pessoa que está fazendo a configuração, não a conta de serviço) Proprietário (verificado ou delegado) Não há tabela. Somente os proprietários podem adicionar usuários a uma propriedade. Colar em Fluxos de Consulta
- Chave JSON da conta de serviço
- O arquivo .json completo da etapa 12. Clique em "Carregar deste computador" abaixo da caixa e selecione o arquivo (ou "De um arquivo no agente…" se o arquivo estiver no computador do agente). Ou abra o arquivo no Bloco de Notas (TextEdit no Mac), selecione tudo, copie e cole do primeiro { ao último }. Ao editar o conector posteriormente, deixe esta caixa em branco para manter a chave armazenada ou insira um arquivo completamente novo para substituí-la.
- URL da propriedade do site
- Clique em Detectar ao lado da caixa assim que a chave for inserida (seu Agente deve estar online). A caixa se transformará em uma lista de todas as propriedades que a conta de serviço pode visualizar, como sc-domain:example.com — siteRestrictedUser. Selecione a sua. Ou digite-a como explicado na etapa 18: sc-domain:example.com para uma propriedade de Domínio, ou o endereço completo com a barra final, como https://www.example.com/, para uma propriedade de prefixo de URL.
Problemas comuns
O teste de conexão falhou com a mensagem "Tipo de chave inválido. Esperava-se 'service_account'".
Por que: O arquivo 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 10 a 12) e use 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 na chave da conta de serviço.
Por que: Apenas parte do arquivo foi copiada, ou o texto foi alterado durante a cópia.
Consertar: Clique em "Carregar deste computador" e selecione o arquivo .json em vez de copiá-lo. Ou abra o arquivo novamente no Bloco de Notas (TextEdit no Mac), pressione Ctrl+A (Cmd+A no Mac), copie e cole sem nada antes ou depois.
O teste de conexão falha com a mensagem "A conta de serviço '…' não possui propriedades no Search Console" ou "A detecção indica que nada foi detectado".
Por que: O Search Console ainda não adicionou a conta de serviço a nenhuma propriedade. As etapas 13 a 17 foram ignoradas, realizadas em outro site ou o Search Console rejeitou o e-mail.
Consertar: Adicione o mesmo endereço de e-mail da etapa 9 como usuário na propriedade (etapas 13 a 17). Verifique se ele agora aparece em Usuários e permissões e clique em Testar novamente.
O teste de conexão falha com a mensagem "A conta de serviço '…' não tem acesso. Adicione-a à propriedade do Search Console.", mesmo que a conta de serviço esteja listada em Usuários e permissões. A detecção pode exibir a própria mensagem do Google: "A API do Google Search Console não foi usada no projeto … anteriormente ou está desativada."
Por que: A API do Google Search Console não está habilitada no projeto do Google Cloud ao qual a chave pertence (a linha `project_id` no arquivo de chave). O Google rejeita essas chamadas com um erro 403, que o teste reporta como falta de acesso.
Consertar: Selecione esse projeto no Google Cloud, ative a API do Google Search Console (etapa 4), aguarde alguns minutos e clique em Testar novamente.
O teste de conexão indica "Conectado", mas gsc.search_analytics permanece vazio e o log do agente mostra o erro "API do Search Analytics: Proibido".
Por que: O URL da propriedade do site não corresponde exatamente a uma propriedade à qual a conta de serviço foi adicionada: domínio-sc: em vez de https://, www em vez de sem www, http em vez de https ou falta uma barra final. O teste verifica apenas se a conta de serviço consegue ver pelo menos uma propriedade. A sincronização lê o URL que você digitou.
Consertar: Em Agentes de Dados, abra o conector e clique em Editar. Clique em Detectar ao lado de URL da Propriedade do Site, selecione a propriedade na lista, clique em Testar conexão e, em seguida, em Salvar alterações.
O Search Console não adiciona a conta de serviço. Ele exibe a mensagem de que o 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 Search Console e o Google Analytics às vezes não reconhecem contas de serviço recém-criadas por um tempo. Desenvolvedores relataram o problema até setembro de 2026. Um erro de digitação ou um espaço no endereço gera 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 costuma funcionar: se você tiver uma (por exemplo, do conector do Google Analytics 4), adicione o e-mail dela e use o arquivo de chave.
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 isentar este projeto da política. O Google documenta uma isenção baseada em tags para um único projeto. Em seguida, repita os passos 11 e 12.
Um conector que funcionava normalmente para de sincronizar e o teste de conexão falha com o erro: "Connection error: … invalid_grant … Invalid JWT Signature".
Por que: A chave foi excluída, desativada ou expirou no Google Cloud.
Consertar: Crie uma nova chave (passos 10 a 12). No Data Agents, abra o conector, clique em Editar, insira o novo arquivo em Chave JSON da conta de serviço, clique em Testar conexão e, em seguida, em Salvar alterações. Exclua a chave antiga no Google Cloud.
O teste de conexão falha com um erro que menciona invalid_grant e JWT inválido: o token deve ser de curta duração.
Por que: O relógio do computador do agente está atrasado em vários minutos. O Google rejeita logins de computadores cujo horário está incorreto.
Consertar: Ative o horário automático (da internet) no computador do Agente e clique em Testar novamente.
Os cliques e impressões em gsc.search_analytics somam menos do que o gráfico de desempenho do Search Console.
Por que: O Google exclui consultas raras (anonimizadas) de cada resposta linha por linha, embora os totais do gráfico ainda as contem. O Google também retorna, no máximo, 50.000 linhas por dia por tipo de pesquisa para cada propriedade. Uma propriedade de prefixo de URL também abrange uma área menor do site do que a propriedade de domínio.
Consertar: Nada está quebrado. Compare a soma das linhas com a tabela do Search Console em vez do total do gráfico e selecione a propriedade Domínio se quiser o site inteiro.
Os dados dos dois ou três dias mais recentes estão faltando em gsc.search_analytics.
Por que: Os dados do Google geralmente ficam disponíveis de 2 a 3 dias após o ocorrido. O Agente lê apenas os dados finais do Google, atualizados até três dias antes da data atual.
Consertar: Nada a alterar. Essas alterações serão refletidas em sincronizações posteriores. Cada sincronização também lê novamente os últimos cinco dias, portanto, as alterações tardias são detectadas.
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 associada ao usuário e a chave continua válida.
Consertar: No Search Console → Configurações → Usuários e permissões, abra o menu ao lado da conta de serviço e clique em Remover acesso. 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
- Histórico: O Search Console armazena os últimos 16 meses. A primeira sincronização do agente lê todos os 16 meses; os dados de datas anteriores não estão disponíveis no Google.
- Atualização: Os dados do Google geralmente ficam prontos após 2 a 3 dias. O Agente lê apenas os dados mais recentes, até três dias antes da data atual, e relê os últimos cinco dias a cada sincronização.
- Linhas: O Google retorna no máximo 50.000 linhas por dia, por tipo de pesquisa, por propriedade, classificadas por cliques. Consultas raras (anonimizadas) nunca aparecem como linhas, portanto, a soma das linhas é menor do que o total exibido nos gráficos do Search Console.
- Tipos de pesquisa: web, imagem, vídeo, notícias e descobrir, cada um na coluna search_type. As linhas da seção Descobrir não possuem consulta nem dispositivo. As linhas da seção Notícias não possuem consulta.
- Cota: O Search Analytics permite 1.200 consultas por minuto por propriedade e por usuário, e 40.000 por minuto (30.000.000 por dia) por projeto do Google Cloud, além de um limite de carga contabilizado a cada 10 minutos e por dia. Consultas agrupadas por página e consultas em longos intervalos de datas consomem mais recursos, portanto, a primeira sincronização de um site muito grande pode exceder a cota. O Agente limita seu processamento a 60 solicitações por minuto.
- Inspeção de URLs: 2.000 inspeções por dia e 600 por minuto por propriedade. É por isso que a tabela url_inspection está desativada por padrão e só é executada sob demanda.
- Novos sites: o Google pode levar até uma semana para gerar dados para um site recém-adicionado.
- Chaves: até 10 chaves por conta de serviço. As chaves nunca expiram por padrão, a menos que sua organização defina um tempo de vida máximo.
- Usuários: uma propriedade pode ter no máximo 100 usuários que não sejam proprietários.
- Custo: O Google não cobra pela API do Search Console.
Etapas verificadas em 8 de outubro de 2026. Fontes: developers.google.com/webmaster-tools/v1/how-tos/authorizing, developers.google.com/webmaster-tools/v1/prereqs, developers.google.com/webmaster-tools/v1/sites, developers.google.com/webmaster-tools/v1/searchanalytics/…, developers.google.com/webmaster-tools/v1/how-tos/all-your…, developers.google.com/webmaster-tools/limits, developers.google.com/webmaster-tools/pricing, developers.google.com/search/blog/2022/10/performance-dat…, developers.google.com/search/blog/2018/06/new-url-inspect…, developers.google.com/identity/protocols/oauth2/service-a…, docs.cloud.google.com/resource-manager/docs/creating-mana…, docs.cloud.google.com/resource-manager/docs/access-control…, docs.cloud.google.com/iam/docs/service-accounts-create, docs.cloud.google.com/iam/docs/keys-create-delete, docs.cloud.google.com/iam/docs/troubleshoot-org-policies, support.google.com/googleapi/answer/6158841?hl=en, support.google.com/webmasters/answer/7687615?hl=en, support.google.com/webmasters/answer/34592?hl=en, support.google.com/webmasters/answer/96568?hl=en, support.google.com/analytics/answer/10737381?hl=en, docs.airbyte.com/integrations/sources/google-search-console, help.imaginaire.co.uk/books/seo-tool/page/grant-access-to…, victorious.com/blog/google-search-console-add-user, seotesting.com/google-search-console/domain-vs-url-prefix, 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…, dev.to/morinaga/what-i-learned-debugging-gsc-url-inspecti….
- 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 de uma conta de serviço do Google que foi adicionada como usuário na sua propriedade do Search Console.
- URL da propriedade do site
- Seu site exatamente como o Search Console o lista, como sc-domain:example.com ou https://example.com/.
Clique em Teste de conexãoQuando lê Conectado, clique SalvarA conexão chega ao seu agente em poucos segundos.
O teste falhou? Geralmente, trata-se de uma permissão ausente ou de uma credencial de uma conta do Search Console incorreta. O passo a passo acima lista as problemas comuns e suas correções.
-
See your data in Query Builder Opcional
You can look at your Search Console account before Excel 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-in’s Saved Queries list, and on any plan you can copy the SQL into the next step.
-
Adicionar fluxos de consulta ao Excel
No Excel, acesse Inserir → Obter suplementos, procurar Fluxos de consultae clique AdicionarOu abra-o diretamente de Consultar fluxos no Microsoft AppSourceUm botão "Consultar fluxos" aparece na faixa de opções. Faça login com a mesma conta.
Funciona no Excel para Microsoft 365 no Windows e no Mac, e no Excel na Web.
-
Puxe sua primeira mesa.
Clique no botão Consultar fluxos e escolha Transmita uma consultaE selecione a conexão que você acabou de fazer.
Digite a consulta que deseja executar. Esta consulta extrai algumas colunas de uma tabela. gsc.search_analytics mesa:
Exemplo · SQLSELECT date, query, clicks, impressions FROM gsc.search_analytics ORDER BY clicks DESC LIMIT 100;
Sob Folha de Destino escolher Criar uma nova planilhaEm seguida, pressione o botão de reprodução (a seta ▶). As linhas serão exibidas no Excel em um ou dois segundos. Pressione-o novamente sempre que os dados forem alterados e a planilha 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.
É 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 Excel ou do Google Sheets.
- 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
O Excel precisa estar no mesmo computador que a sua conta do Search Console?
Não. Apenas o Agente precisa estar no mesmo local que sua conta do Search Console. O Excel pode ser executado em qualquer computador com conexão à internet, incluindo o Excel na Web e o Excel no Mac. Faça login no suplemento com sua conta 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.
Funciona com o Excel para Mac?
Sim. Excel para Microsoft 365 no Mac e no Windows, e Excel na Web.
Guias relacionados
Todos os guias para Search Console
Google Sheets
Claude (MCP)
REST API- Sincronizar com Google Sheets
Sincronizar com Airtable
Sincronizar com Smartsheet
Sincronizar com Baserow
Sincronizar com SeaTable
Sincronizar com Anvil.works
Não é bem a sua configuração?
- Deseja consultar as próprias pastas de trabalho do Excel? A opção Pasta do Excel lê uma pasta de pastas de trabalho como tabelas → Excel Folder
- Quer visitas, usuários e conversões no seu site em vez de cliques na busca do Google? O Google Analytics 4 fornece tabelas de tráfego diário diretamente do GA4 → GA4
Setup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish