Conectar ao Google

Pegue uma chave de acesso do Google uma única vez, cole no aplicativo e escolha o seu site para ler os dados do Search Console e do Analytics 4.

A interface do aplicativo está disponível em turco e inglês. O idioma é escolhido em Ayarlar → Görünüm → Dil. Este guia mostra cada botão e cada nome de tela em turco, com o significado em português entre parênteses.

Ao fim desta página, o aplicativo estará conectado ao Google em seu nome e lerá os dados do seu site. Para isso, você pega uma "chave de acesso do Google" uma única vez. Leva cerca de dez minutos e você nunca precisa repetir. Há também um caminho mais curto, com uma conta de serviço, no fim da página.

O que você precisa

Um site verificado no Search Console (uma propriedade). Se não estiver verificado, o aplicativo não o vê na lista.
Para o Analytics 4, pelo menos a permissão de "Leitor" nessa propriedade. É opcional. O Search Console sozinho basta.
Uma conta Google. O Google Cloud Console (o painel de desenvolvedores do Google) é gratuito e não pede cartão.
O aplicativo aberto. Você vai copiar dele os dois endereços de redirecionamento (os endereços para os quais o Google devolve você ao aplicativo depois que você dá a permissão).

Passos

No aplicativo, abra Ayarlar → Google (Configurações → Google). Você vê dois endereços. Um termina com /api/gsc/oauth/callback (Search Console) e o outro com /api/ga4/oauth/callback (Analytics). No pacote para Windows, os endereços começam com http://127.0.0.1:3001. No Docker, começam com http://localhost:3001. Anote os dois em algum lugar.
No navegador, vá a console.cloud.google.com. No seletor de projetos, no alto da página, escolha Yeni proje (Novo projeto). O nome não importa. Você pode escrever "seowatcher".
Abra a página API'ler ve Hizmetler → Kitaplık (APIs e serviços → Biblioteca). Digite Google Search Console API na caixa de busca, clique nela e escolha Etkinleştir (Ativar). Se você também for conectar o Analytics, faça o mesmo para a Google Analytics Admin API e a Google Analytics Data API.
Abra a página API'ler ve Hizmetler → OAuth izin ekranı (APIs e serviços → Tela de consentimento OAuth). Como tipo de usuário, escolha Harici (Externo). Como nome do aplicativo, escreva o que quiser e, nos campos de e-mail, o seu próprio endereço. O estado de publicação pode continuar "Teste".
Na mesma página, adicione a sua própria conta Google em Test kullanıcıları (Usuários de teste). O Google não precisa aprovar mais nada.
Na página API'ler ve Hizmetler → Kimlik bilgileri (APIs e serviços → Credenciais), escolha Kimlik bilgisi oluştur (Criar credenciais) e depois OAuth istemci kimliği (ID do cliente OAuth). Essa é a sua chave de acesso do Google.
Como tipo de aplicativo, escolha Web uygulaması (Aplicativo da Web).
Em Yetkilendirilmiş yönlendirme URI'leri (URIs de redirecionamento autorizados), adicione os dois endereços do passo 1. Não coloque barra no fim. A diferença de um único caractere causa no Google o erro "redirect_uri_mismatch" (o endereço não corresponde).
Escolha Oluştur (Criar). O Google mostra um ID do cliente e uma chave secreta.
Volte ao aplicativo. Em Ayarlar → Google (Configurações → Google), cole o ID que termina em .apps.googleusercontent.com no campo İstemci kimliği (ID do cliente). Cole a chave que começa com GOCSPX- no campo Gizli anahtar (Chave secreta).
Escolha Kaydet (Salvar). Aparece o aviso "Google erişim anahtarı kaydedildi" (Chave de acesso do Google salva). Não é preciso reiniciar. Se você colar o ID no campo errado, o aplicativo avisa: "Kimlik .apps.googleusercontent.com ile bitmeli. Gizli anahtarı değil, istemci kimliğini yapıştırın." (O ID deve terminar em .apps.googleusercontent.com. Cole o ID do cliente, não a chave secreta.)
Se você ainda não tem um projeto, crie um primeiro com Yeni proje (Novo projeto). Veja Projetos.
Vá ao seu projeto: Proje ayarları → Bağlantılar (Configurações do projeto → Conexões). No cartão Google Search Console, escolha Bağlan (Conectar).
Na tela de permissão do Google, escolha a conta que você adicionou como usuário de teste e dê a permissão. Ao voltar ao aplicativo, aparece o aviso "Search Console bağlandı" (Search Console conectado).
Na lista Mülk seç (Escolher propriedade), escolha o seu site e depois Mülkü kaydet (Salvar propriedade). Se você escolher uma propriedade de domínio, o cartão diz "Alan adı mülkü: tüm alt alan adlarını ve http/https adreslerini kapsar." (Propriedade de domínio: abrange todos os subdomínios e os endereços http/https.)
Para o Analytics, na mesma tela, escolha Bağlan (Conectar) no cartão Google Analytics, dê a permissão e escolha a propriedade. As duas conexões pedem permissões separadas. Uma não cobre a outra.

Um caminho mais curto: a conta de serviço

Uma conta de serviço é uma conta especial que se conecta ao Google no seu lugar. Você não precisa da tela de consentimento. Para a maioria das pessoas, esse é o caminho recomendado. O caminho OAuth acima é para quem prefere entrar com a própria conta Google.

Vá a console.cloud.google.com e abra IAM & Admin → Service Accounts (em um console em turco: IAM ve Yönetici → Hizmet hesapları). Confira que, no mesmo projeto do Cloud, as APIs do passo 3 estão ativadas.
Clique em Create service account. Dê um nome, por exemplo "seowatcher". Pule as etapas de função e clique em Done.
Na linha da nova conta, abra Keys → Add key → Create new key, escolha JSON e confirme. Um arquivo é baixado. Mantenha-o em sigilo.
No seowatcher, abra Ayarlar → Hizmet hesabı (Configurações → Conta de serviço). Cole o conteúdo do arquivo inteiro e salve. A tela mostra o endereço de e-mail da conta de serviço. Copie-o.
No Search Console, abra Settings → Users and permissions → Add user. Digite esse endereço de e-mail e escolha a permissão Full.
Para o Analytics, no Google Analytics, abra Admin → Access management da propriedade. Adicione o mesmo endereço de e-mail como Viewer.

Se uma conta de serviço estiver salva, o aplicativo dá preferência a ela. A linha "Şu an kullanılan" (Em uso agora) na tela Ayarlar (Configurações) mostra qual está ativa.

Verificação

Nos cartões de Proje ayarları → Bağlantılar (Configurações do projeto → Conexões), o selo deve dizer Bağlı (Conectado).
Os quatro cartões de números da tela Panel (Painel) devem se preencher em poucos segundos. Em um site novo, os números podem ser zero. Isso não é um erro de conexão.
O selo em Ayarlar → Google (Configurações → Google) deve dizer Kayıtlı (Salvo).

Perguntas frequentes

Onde a chave secreta fica guardada? No banco de dados deste computador, criptografada. A chave que a criptografa é o arquivo instance-secret (na pasta de dados, no Windows; no volume de dados, no Docker). A chave nunca é enviada ao navegador.

Posso usar a mesma chave de acesso em mais de um projeto? Sim. Uma por instalação basta. Cada projeto escolhe a sua própria propriedade.

A conexão caiu depois de alguns dias. Em aplicativos com estado "Teste", o Google pode limitar a permissão a sete dias. O cartão diz "Bağlantının süresi doldu" (A conexão expirou). Yeniden bağlan (Reconectar) resolve. A solução duradoura é passar a tela de consentimento para "Produção" ou trocar para uma conta de serviço.

Que permissões ele pede? Somente leitura para o Search Console (webmasters.readonly) e somente leitura para o Analytics (analytics.readonly). O aplicativo não consegue alterar nada no Google.

Se algo der errado

O Google diz "redirect_uri_mismatch". O endereço de redirecionamento no Cloud Console não é exatamente igual ao do aplicativo. Use o botão de copiar da tela Ayarlar (Configurações). Basta http no lugar de https, 127.0.0.1 no lugar de localhost, ou uma barra no fim para causar o erro.
Aparece o aviso "Google erişim anahtarı eksik" (falta a chave de acesso do Google). Os passos 10 e 11 foram pulados ou o salvamento falhou. Na tela Ayarlar (Configurações), o selo deve dizer Kayıtlı (Salvo).
O Google diz "access_denied". A conta com que você entrou não está na lista de usuários de teste da tela de consentimento. Adicione a conta à lista ou escolha a conta certa.
A lista de propriedades está vazia. Esta conta não tem nenhum site verificado no Search Console nem permissão no Analytics. Verifique o site primeiro.
Aparece "Bağlantısı tamamlanmadı" (Conexão não concluída) e "state_mismatch". Você abriu a tela de permissão em duas abas ou esperou mais de dez minutos. Tente de novo desde o início, em uma única aba. Se os cookies do navegador (pequenos arquivos que os sites guardam no navegador) estiverem desativados, ative-os.
Aparece "Google hesabı zaten bağlı" (A conta Google já está conectada). A conta já foi conectada a outro registro. Remova o antigo com Hesabı kaldır (Remover conta) no seletor de propriedades e conecte de novo.
As conexões caíram depois de uma atualização. A chave de criptografia mudou (no Docker, BETTER_AUTH_SECRET foi adicionada ou o volume de dados foi recriado). Escolha Yeniden bağlan (Reconectar) nos cartões.

Última atualização: 24 de outubro de 2026. Viu algum erro? Relate no GitHub.