# Como corrigir a integração com o Google Search Console no SEOPress

O erro de integração do SEOPress com o GSC (Google Search Console) ocorre quando a meta tag de verificação não é impressa no head do site ou quando a autorização da API do Google Search Console (recurso do SEOPress PRO) expira ou é concedida para a conta ou propriedade errada.

## O que é integração do Google Search Console no SEOPress?

A integração do SEOPress com o GSC (Google Search Console) acontece em duas frentes distintas, e o erro pode estar em qualquer uma delas. A primeira é a verificação de propriedade: você cola o código fornecido pelo Google no campo de verificação do SEOPress, e o plugin imprime a meta tag google-site-verification no head de todas as páginas para o Google confirmar que você é o dono do site. A segunda é a conexão com a API do Google Search Console, recurso exclusivo do SEOPress PRO, que autoriza o plugin via OAuth do Google a puxar dados de cliques, impressões e posição para dentro do painel do WordPress.

O erro aparece quando uma dessas pontes quebra. Na verificação, o Google retorna que não encontrou a meta tag esperada, geralmente porque a tag não está sendo impressa no head, foi colada com o atributo content inteiro em vez de só o valor, ou está sendo servida de uma versão em cache da página. Na API, a conexão para de funcionar quando o token de autorização é revogado ou expira, quando a conta autorizada não tem acesso à propriedade no Search Console, ou quando a propriedade selecionada no SEOPress não corresponde ao domínio real do site.

## Como identificar

- Ao verificar a propriedade no Google Search Console aparece a mensagem 'Verification failed' ou 'We couldn't verify your ownership', mesmo com o código colado no SEOPress.
- Em SEO -> Advanced -> Google verification o campo aceita o código, mas ao inspecionar o código-fonte da home a meta tag google-site-verification não está presente no head.
- Na aba de Google Search Console do SEOPress PRO surge 'Unable to connect to Google' ou os gráficos de cliques e impressões ficam vazios após a autorização.
- Depois de algumas semanas a conexão da API para de atualizar e o SEOPress pede uma nova autorização do Google, sinal de token expirado ou revogado.
- Ao autorizar a API o Google retorna 'redirect_uri_mismatch' ou 'access_denied' e a tela do SEOPress volta sem concluir a conexão.

**Antes de começar:** Antes de mexer em plugins de SEO, cache ou nas autorizações do Google, faça um backup do site ou teste primeiro em staging. Ao revogar o acesso de terceiros na conta Google, confirme que está removendo apenas o token do SEOPress, e não o de outras ferramentas que dependem da mesma conta.

## Como prevenir

- Use apenas um plugin de SEO para gerenciar a verificação do Google, evitando meta tags de verificação duplicadas no head do site.
- Sempre limpe o cache do plugin de cache e da CDN depois de adicionar ou alterar o código de verificação, para o Google ler a versão atual da página.
- Verifique a propriedade no Search Console pelo método Domain (DNS) quando possível, pois ele não depende de uma meta tag no HTML e sobrevive a trocas de tema e plugin.
- Revise periodicamente o acesso de terceiros na conta Google para saber quando um token da API expirou e reautorizar o SEOPress antes que os dados parem de atualizar.

Erros relacionados

- [Como corrigir o sitemap XML que não gera no SEOPress](https://full.services/wp-fixer/corrigir-sitemap-xml-seopress/)
- [Como corrigir o erro de schema markup no SEOPress](https://full.services/wp-fixer/corrigir-schema-markup-seopress/)
- [Como corrigir o erro de Open Graph no SEOPress](https://full.services/wp-fixer/corrigir-open-graph-seopress/)

## Causa

- O código colado no campo Google verification do SEOPress inclui a tag inteira (a meta name google-site-verification com content) em vez de apenas o valor do atributo content, fazendo o SEOPress gerar uma meta tag malformada que o Google não reconhece.
- Um plugin de cache ou a CDN está servindo uma versão antiga da home sem a meta tag de verificação recém-adicionada, então o Google verifica o HTML em cache e não encontra a tag.
- Outro plugin de SEO (Yoast, Rank Math, All in One SEO) ou o tema também imprime sua própria meta tag de verificação do Google, gerando tags duplicadas ou conflitantes no head que confundem a verificação.
- O token OAuth da API do Google Search Console expirou ou foi revogado na conta Google (em myaccount.google.com -> Segurança -> Acesso de terceiros), então o SEOPress PRO perde a permissão de ler os dados.
- A conta Google autorizada não é proprietária nem usuário da propriedade no Search Console, ou a propriedade selecionada no SEOPress (domínio versus prefixo de URL, http versus https, com e sem www) não corresponde à propriedade real do site.

## Como resolver

1. Cole apenas o valor do código de verificação: No Google Search Console, escolha o método de verificação por HTML tag e copie somente o trecho que vem dentro de content, sem a tag inteira. Em SEOPress, cole esse valor puro no campo de verificação do Google. O plugin monta a meta tag completa sozinho.

```
Google Search Console -> Settings -> Ownership verification -> HTML tag
Copie apenas o valor entre aspas do atributo content (sem a meta tag inteira)
Painel WP -> SEO -> Advanced -> aba Advanced -> campo Google site verification -> cole o valor -> Save
```

2. Confirme a meta tag no código-fonte e limpe o cache: Após salvar, abra a home, veja o código-fonte e confirme que a meta tag google-site-verification está no head. Se não estiver, limpe o cache do plugin de cache e da CDN para o Google ver a versão atualizada antes de clicar em Verify.

```
Abra a home -> clique direito -> Ver código-fonte da página
Procure por: meta name="google-site-verification"
Limpe o cache do plugin de cache e faça purge na CDN (ex.: Cloudflare)
Google Search Console -> clique em Verify
```

3. Remova verificações duplicadas de outros plugins: Se houver mais de uma meta tag de verificação do Google no head, desative o código de verificação dos outros plugins de SEO e do tema, deixando apenas o do SEOPress, para o Google não encontrar tags conflitantes.

```
No código-fonte, conte quantas meta tags google-site-verification existem
Painel WP -> abra o outro plugin de SEO (Yoast/Rank Math/AIOSEO) e limpe o campo de verificação do Google
Verifique nas opções do tema se há um campo de verificação preenchido e limpe-o
```

4. Reautorize a API do Google Search Console no SEOPress PRO: Para a conexão da API (SEOPress PRO), desconecte a conta atual e refaça a autorização do zero. Isso gera um novo token OAuth e resolve tokens expirados ou revogados.

```
Painel WP -> SEO -> Google Analytics (ou Tools) -> seção Google Search Console
Clique em Disconnect / Revoke para limpar a conexão atual
Clique em Connect e autorize com a conta Google dona da propriedade no Search Console
Cole o código de autorização retornado pelo Google de volta no SEOPress, se solicitado
```

5. Confira a conta e a propriedade corretas: Garanta que a conta Google autorizada tem acesso à propriedade no Search Console e que a propriedade escolhida no SEOPress é exatamente a do site (mesmo protocolo e subdomínio). Propriedade errada deixa os dados vazios mesmo com a conexão ativa.

```
Google Search Console -> Settings -> Users and permissions -> confirme a conta como Owner
Confirme se a propriedade é Domain ou URL-prefix e se bate com https e www do site
Painel WP -> SEOPress -> selecione a propriedade correta na lista após reconectar
```


## Código

```php
<?php
// Fallback: imprime a meta tag de verificacao do Google Search Console no head,
// util quando o campo do plugin nao esta gerando a tag. Cole apenas o VALOR do content.
add_action( 'wp_head', 'full_google_site_verification', 1 );
function full_google_site_verification() {
    $codigo = 'COLE_AQUI_SOMENTE_O_VALOR_DO_CONTENT';
    if ( empty( $codigo ) ) {
        return;
    }
    printf(
        '<meta name="google-site-verification" content="%s" />' . "n",
        esc_attr( $codigo )
    );
}
```

## Perguntas frequentes

### Por que o Google Search Console não verifica meu site mesmo com o código no SEOPress

Quase sempre porque a meta tag não chega ao head: ou você colou a tag inteira em vez de só o valor do content, ou o cache está servindo uma versão antiga da página. Cole apenas o valor, salve, limpe o cache da CDN e do plugin de cache e tente verificar de novo.

### Onde fica o campo de verificação do Google no SEOPress

O campo de verificação de propriedade fica em SEO, na seção Advanced, dentro da aba Advanced, no campo Google site verification. Cole ali somente o valor do código fornecido pelo Google, que o SEOPress monta a meta tag completa no head.

### A integração com a API do Google Search Console é grátis no SEOPress

Não. A verificação de propriedade por meta tag está na versão gratuita, mas a conexão com a API do Google Search Console, que traz cliques, impressões e posição para dentro do WordPress, é um recurso do SEOPress PRO.

### Por que a conexão da API do Search Console parou de funcionar sozinha

Tokens OAuth do Google expiram ou podem ser revogados após mudanças de senha ou de permissões. Quando isso acontece, o SEOPress perde o acesso e os dados deixam de atualizar. Basta desconectar e reautorizar a conta para gerar um novo token.

### Posso colar a meta tag inteira do Google no campo do SEOPress

Não. Cole apenas o valor que está dentro do atributo content, sem a tag meta em volta. Se colar a tag inteira, o SEOPress gera uma meta tag malformada e o Google não reconhece a verificação.

### O Google diz que minha propriedade não foi encontrada na API do SEOPress

Isso indica que a conta autorizada não é proprietária da propriedade no Search Console ou que a propriedade selecionada não corresponde ao site, por exemplo Domain contra URL-prefix, ou http contra https. Confira as permissões em Users and permissions e escolha a propriedade exata do site.

### Preciso reautorizar a API toda vez que troco de plugin de SEO

A autorização da API é independente da meta tag de verificação. Trocar ou desativar outro plugin de SEO não derruba o token do SEOPress, mas convém confirmar que apenas o SEOPress imprime a verificação para não gerar tags duplicadas no head.

**Fonte:** [SEOPress — Guias oficiais (verificação e API do Google Search Console)](https://www.seopress.org/support/guides/)