A conexão com o Google Search Console é feita por OAuth: você entra com a sua conta Google, autoriza o acesso de leitura e, de volta à Toca, escolhe qual propriedade (site) será consultada. Nenhuma senha fica armazenada na Toca — a autorização acontece na tela do próprio Google.

Antes de começar

• Tenha uma conta Google com acesso à propriedade no Search Console — o seletor da Toca mostra apenas as propriedades que esse usuário acessa.
• O site precisa estar verificado no Search Console antes da conexão (confirme na documentação oficial como verificar a propriedade).
• Vale saber o tipo da propriedade: uma propriedade de domínio (sc-domain:exemplo.com) cobre todos os subdomínios e protocolos; uma propriedade de prefixo de URL (https://exemplo.com/) cobre apenas aquele prefixo exato.
• A autorização pedida é somente de leitura do Search Console.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Google Search Console e clique em Conectar.
3. Entre com a sua conta Google e autorize o acesso na tela de consentimento.
4. De volta à Toca, o card exibe um seletor de propriedade, com os sites que o seu usuário acessa no Search Console. Escolha a propriedade que a Toca deve consultar.
5. Ao selecionar, a escolha é salva ("Propriedade GSC atualizada.") e a integração fica ativa.

O que a Toca acessa

Com a conexão ativa, a Toca lê a busca orgânica do Google para a propriedade escolhida: as consultas (palavras) que trazem tráfego, cliques, impressões, CTR, posição média, páginas e dispositivos. A integração é somente leitura: a Toca não altera nada no seu Search Console.

Manutenção da conexão

A autorização usa um token de atualização que a Toca renova automaticamente — a conexão permanece ativa até você desconectar a integração na Toca ou revogar o acesso do aplicativo na sua conta Google. Se o acesso for revogado no Google, refaça a conexão pelo card em Configurações → Integrações.

Problemas comuns

• "Nenhuma propriedade disponível" — o usuário Google que autorizou não tem propriedades no Search Console. Conecte com a conta certa ou peça acesso à propriedade a quem a administra.
• Os números não batem com o esperado — confira o tipo da propriedade escolhida: o prefixo de URL cobre só aquele prefixo exato, enquanto a propriedade de domínio cobre subdomínios e protocolos. Se for o caso, escolha outra propriedade no seletor.
• Quero trocar a propriedade — não é preciso reconectar: basta escolher outra no seletor do card.