API de Indexação do Google explicada: a correção no GSC para tentar primeiro
Por Toy Wen Da, Cofundador · Atualizado em · 7 min de leitura
Traduzido do original em inglês. Ler em inglês
A API de indexação do Google (Google Indexing API) permite avisar o Google diretamente quando uma página é nova, foi atualizada ou foi excluída. O Google então coloca a URL em uma fila de rastreamento prioritária, em vez de esperar para descobrir a mudança por conta própria. A API acelera o rastreamento, mas não garante nada sobre a indexação. Se uma página aparecer como "Discovered, currently not indexed", tente primeiro a ferramenta gratuita de inspeção de URL do Search Console.
O que a API faz e o que ela não faz
Você envia ao Google uma URL junto com um tipo de notificação, URL_UPDATED ou URL_DELETED. O Google coloca a URL na fila de rastreamento com prioridade maior do que a da programação normal baseada em sitemap, e o rastreador ainda precisa visitar a página e decidir se ela merece um lugar no índice.
Várias coisas ficam fora do alcance da API:
- Ela não indexa uma URL diretamente e não consegue sobrepor os sinais de qualidade do Google, então uma página fraca ou duplicada não entra mais rápido.
- Ela não tem efeito sobre o ranqueamento, porque atua apenas no rastreamento.
- Ela não substitui o seu sitemap, que ainda deve conter a maior parte das suas URLs.
- Ela não tem suporte oficial para todos os tipos de conteúdo. Na prática, ela aceita outras URLs, mas o Google não prometeu que isso continuará funcionando.
O equívoco mais comum é achar que um envio bem-sucedido significa que a página será indexada. A API faz o Google notar a página mais cedo, e nada nela faz o Google querer a página.
Veja o problema primeiro: simule o Googlebot
Antes de mexer no Search Console ou em qualquer API, confira o que o Googlebot vê quando visita a página. Muitos problemas de "indexação" são, na verdade, problemas de renderização ou de bloqueio: uma tag noindex esquecida por engano, uma regra no robots.txt ou conteúdo em JavaScript que nunca carrega para um rastreador.
Passe a página pelo Googlebot Simulator gratuito. Ele mostra o HTML renderizado, os códigos de status e as diretivas de bloqueio do jeito que o rastreador do Google as encontra. Se ele revelar uma tag noindex ou um recurso bloqueado, corrigir isso vai ajudar mais do que qualquer chamada de API.
Corrija primeiro dentro do Google Search Console
Para quase toda reclamação do tipo "minha página não indexa", as ferramentas do próprio Search Console são o ponto de partida certo. A sequência abaixo cobre o processo inteiro.
Passo 1: inspecione a URL
Abra o Google Search Console, selecione sua propriedade e cole a URL afetada na ferramenta de Inspeção de URL, no alto da página. Ela informa se a URL está no Google, se existe uma versão rastreada e qual URL canônica o Google escolheu.
Passo 2: leia o status com atenção
O status de cobertura que o Search Console informa mostra o que fazer a seguir.
| Status no Search Console | O que significa | O que fazer |
|---|---|---|
| Submitted and indexed | A página está ativa no índice do Google | Nenhuma ação necessária |
| Crawled, currently not indexed | O Google visitou, mas optou por não indexar | Melhore a qualidade do conteúdo e verifique se há duplicação |
| Discovered, currently not indexed | O Google conhece a URL, mas ainda não a rastreou | Solicite a indexação; em sites grandes, verifique o orçamento de rastreamento |
| URL is unknown to Google | Nunca foi vista antes | Envie pelo sitemap e solicite a indexação |
| Blocked by robots.txt | O rastreador está proibido de acessar | Edite o robots.txt |
| Alternate page with proper canonical tag | O Google indexou outra URL como canônica | Verifique se há conteúdo duplicado ou quase duplicado |
Passo 3: solicite a indexação
Se a inspeção mostrar que a página não está indexada, clique em Solicitar indexação. O Google coloca a URL na fila para um rastreamento prioritário, de modo parecido com o que faz com a API, e a opção é gratuita e fica no console que você já usa.
Passo 4: volte depois e não faça spam
Espere alguns dias antes de solicitar de novo para a mesma URL. Solicitações repetidas para uma mesma página não aceleram nada e podem parecer manipulação para os sistemas do Google.
Quando o Google Search Console basta e quando não basta
O Search Console basta nestes casos:
- Você tem uma ou poucas páginas travadas em "Discovered, currently not indexed".
- Você acabou de publicar algo e quer que seja verificado mais rápido.
- Seu site tem algumas centenas ou alguns milhares de URLs, bem dentro do orçamento de rastreamento normal.
Você precisa de algo a mais, seja a Indexing API ou um serviço construído sobre ela, nestes casos:
- Você administra um site de vagas ou de eventos, com páginas que se enquadram nos tipos de schema
JobPostingouBroadcastEvent, os que a API oficialmente aceita. - Você gerencia um sitemap grande, com dezenas de milhares de URLs, em que as páginas novas ficam semanas esquecidas até o rastreamento programado do Google chegar a elas. Um caso documentado envolveu um e-commerce com 80.000 URLs de produtos em que as novas listagens esperavam cerca de duas semanas pelo primeiro rastreamento, e o envio pela API reduziu esse prazo para menos de seis horas.
- Você está migrando de domínio e precisa que o Google abandone rápido uma canônica antiga. Um blogueiro que saiu de um subdomínio do GitHub Pages para um domínio próprio descobriu que as solicitações manuais no Search Console não mudaram a escolha de canônica do Google em 30 dias, e isso é parte do motivo pelo qual alguns desenvolvedores criam scripts de envio em massa.
- Você precisa executar o processo todos os dias, e não apenas uma vez.
- Você quer que as remoções sejam reconhecidas rapidamente. As notificações
URL_DELETEDsão uma forma limpa de avisar o Google que uma vaga expirada ou um produto removido saiu do ar.
Se nenhum desses casos se aplica a você, fique com o caminho gratuito. Montar a autenticação da API para um único post de blog travado dá muito trabalho de engenharia para um problema que o Search Console resolve em dois cliques.
Como a API funciona, em termos simples
Se você se enquadra na abordagem mais pesada, a configuração tem cinco etapas, e nenhuma delas exige código até a última.
- Crie um projeto no Google Cloud e ative a Indexing API nele.
- Crie uma conta de serviço e baixe a chave privada dela, que é um arquivo JSON.
- Adicione essa conta de serviço como Proprietário (Owner) nas permissões de usuário da propriedade do Search Console. Quase todo mundo erra esta etapa na primeira vez, e pulá-la faz toda chamada à API retornar um erro 403.
- Aguarde a propagação da permissão, que pode levar de alguns minutos a algumas horas até as chamadas começarem a funcionar.
- Envie as URLs com o tipo de notificação
URL_UPDATEDouURL_DELETED, autenticadas com um token OAuth trocado pela sua chave privada.
Um script que faz isso costuma ter as mesmas poucas partes: um módulo de autenticação que carrega a chave, uma função que envia uma URL e tenta de novo em caso de falha, e um laço principal que lê as URLs do seu sitemap e as envia, sem passar da cota diária.
Cada projeto recebe uma cota padrão de 200 solicitações de publicação por dia, com atualizações e remoções contadas em conjunto, além de 180 solicitações de metadados e 380 solicitações no total por minuto. O limite diário é zerado à meia-noite, no horário do Pacífico. Uma atualização da documentação em outubro de 2026, noticiada pelo Search Engine Journal, removeu o formulário de pedido de aprovação e as etapas para solicitar uma cota maior, e o Google não disse se a exigência de aprovação em si mudou. Se você está planejando contar com um aumento de cota, consulte a página de cotas atual do Google API Console em vez de guias mais antigos.
Várias ferramentas comerciais encapsulam essa mesma API em um painel, para que você não precise escrever o código de autenticação. Elas costumam cobrar uma mensalidade ou uma taxa por projeto e anunciam tempos médios de indexação de alguns minutos, embora os resultados ainda dependam da fila de rastreamento do Google e da qualidade da página.
Quando a API é a ferramenta errada
Deixe-a de lado para conteúdo perene, para páginas que o Google já rastreou e rejeitou e para qualquer site em que um sitemap limpo e uma boa estrutura de links internos já façam as URLs novas serem captadas em um prazo razoável. Para esses sites, as alternativas são um sitemap enviado no Search Console e a opção Solicitar indexação manual para uma página ocasional. O sitemap é o caminho principal de descoberta das suas URLs em grande volume, enquanto a API é uma faixa prioritária para páginas específicas.
Erros comuns a evitar
- Achar que envio é o mesmo que indexação. A API coloca um rastreamento na fila e não promete resultado, então uma página fraca ou duplicada não indexa mais rápido só porque você a enviou pela API.
- Pular a etapa de propriedade no Search Console. A conta de serviço precisa ser Proprietária (Owner) da propriedade, e não uma usuária comum, ou toda chamada falha com um erro 403.
- Usá-la em conteúdo fora dos tipos aceitos e esperar a confiabilidade que o Google promete para vagas de emprego e transmissões ao vivo.
- Solicitar a indexação da mesma URL no Search Console várias vezes em poucas horas.
- Tratar a API como um substituto do sitemap.
- Subir a chave JSON da conta de serviço para um repositório público. Trate-a como uma senha.
Se uma página continua sem indexar, não importa o que você solicite, a causa muitas vezes é a qualidade do conteúdo ou a duplicação, e não a velocidade de rastreamento. Uma ferramenta gratuita para confirmar o ranqueamento de palavras-chave antes de presumir que a indexação é o gargalo pode ajudar você a verificar.
Perguntas frequentes
A Google Indexing API garante que minha página seja indexada?
Não. Ela avisa o Google de que uma URL mudou e pede um rastreamento prioritário. O rastreador do Google ainda visita a página e aplica as verificações normais de qualidade e relevância antes de decidir indexá-la.
Posso usar a Indexing API para qualquer tipo de página?
Oficialmente, o Google diz que a API aceita páginas com dados estruturados JobPosting ou BroadcastEvent. Muita gente envia outros tipos de URL e vê que elas são aceitas, mas o Google não se comprometeu a manter isso funcionando de forma confiável no futuro.
Qual é o limite diário da Indexing API?
O padrão é de 200 solicitações de publicação por dia por projeto, somando atualizações e remoções, com um teto de 180 solicitações de metadados por minuto. A contagem diária é zerada à meia-noite, no horário do Pacífico.
Por que a API retorna 403 Forbidden?
A causa habitual é que a conta de serviço não foi adicionada como Proprietária (Owner) da propriedade no Search Console. As permissões também podem levar de alguns minutos a algumas horas para se propagar, então uma chamada feita logo após a configuração ainda pode falhar.
A API pode obrigar o Google a rastrear uma página de novo?
Ela pede um rastreamento prioritário, e o Google decide o que acontece depois. Rastrear uma página não obriga o Google a indexá-la.
Solicitar indexação no Search Console é o mesmo que usar a Indexing API?
Ambas colocam uma URL em uma fila de rastreamento prioritária. A opção Solicitar indexação é gratuita, manual e embutida no console que você já usa, enquanto a API automatiza o mesmo tipo de solicitação para muitas URLs.
Qual é a diferença entre a API e enviar um sitemap?
Um sitemap lista suas URLs para o Google rastrear no ritmo dele e continua sendo o caminho principal para a maior parte das suas páginas. A API empurra URLs individuais, como as novas ou as excluídas, para uma fila mais rápida.
Por que o Google diz "Discovered, currently not indexed" mesmo depois de eu solicitar a indexação?
Em geral, o Google está dando baixa prioridade à página por causa do orçamento de rastreamento, da qualidade percebida do conteúdo ou da semelhança com outras páginas do seu site. Corrigir a página em si costuma ser mais eficaz do que enviar solicitações repetidas.
Fale com a equipe
Correr atrás de uma única URL travada no Search Console leva cerca de cinco minutos. Correr atrás de problemas de indexação no site inteiro, semana após semana, é um mau uso de chamadas de API disparadas à mão. Se você quer ter um retrato claro de quais páginas estão indexadas, quais estão travadas e por quê, fale com a equipe e receba um relatório de amostra feito com base no seu próprio site.
Leitura relacionada: Search Console API: How to Get Access and What It Returns.
Fontes
Sobre o autor
O SearchBlueprint pesquisou, escreveu e avaliou este artigo com o mesmo pipeline de conteúdo que nossos clientes usam nos próprios sites. A nota que aparece na assinatura é a que nosso mecanismo de conteúdo deu a esta página antes de ela ser publicada. Nada aqui passa por revisão manual, e esse é justamente o ponto: é o resultado do produto, publicado onde qualquer pessoa pode conferir.