API de indexação do Google

TL;DR — A API de Indexação do Google é uma forma de os proprietários de sites dizerem ao Google “esta página mudou, por favor, rastreie-a novamente” por meio de código, em vez de clicar em botões. Mas aqui está o detalhe que a maioria dos guias ignora: o Google só a suporta oficialmente para páginas de vagas de emprego e páginas de transmissão ao vivo. Ela não é um atalho para indexar seus posts de blog ou páginas de produto mais rápido — o Google já disse isso repetidamente.

O que é a API de Indexação

Quando você publica ou altera uma página, normalmente espera que o Google volte e rastreie-a novamente em sua própria programação. A API de Indexação é uma forma de enviar uma notificação ao Google — “ei, esta URL é nova/atualizada” ou “esta URL sumiu, remova-a”. Você faz isso com código (um pequeno programa que chama os servidores do Google), não clicando em um painel.

Isso parece poderoso, e é — para exatamente as coisas para as quais foi criado.

A única coisa para entender

O Google só suporta oficialmente a API de Indexação para dois tipos de páginas:

1. Vagas de emprego — páginas com dados estruturados JobPosting (listas de vagas, que expiram e precisam sair rapidamente).
2. Transmissões ao vivo — páginas com dados estruturados BroadcastEvent (eventos de vídeo ao vivo, que só importam durante a transmissão).

É isso. Ambos são conteúdos sensíveis ao tempo que ficam obsoletos rapidamente, por isso o Google criou uma via rápida para eles.

Se você não tem listas de vagas ou transmissões ao vivo, a API de Indexação não é sua ferramenta — não importa o que um plugin ou SaaS de “indexe em horas” diga.

O mito a ignorar

O maior mito online é: “Use a API de Indexação para indexar qualquer página rapidamente.” Não funciona assim, e o Google repetidamente chamou o uso dela para páginas normais de uso indevido. As pessoas fazem mesmo assim porque ferramentas vendem isso como um truque de crescimento — mas o Google pode (e diz que vai) revogar seu acesso por abusar dela.

Há uma segunda armadilha também: quando você envia uma URL e recebe uma resposta de “sucesso”, isso só significa que o Google recebeu sua solicitação. Isso não significa que a página foi indexada. Muitas ferramentas borram essa linha; a própria documentação do Google é clara sobre isso.

O que fazer em vez disso para indexação mais rápida

Para páginas regulares (blogs, produtos, artigos), as coisas que realmente ajudam são chatas, mas reais:

• Envie um sitemap XML no Google Search Console.
• Link para suas novas páginas a partir de outras páginas do seu site.
• Torne a página genuinamente digna de indexação (qualidade, não conteúdo ralo).
• Para um caso pontual, use “Request indexing” na ferramenta URL Inspection do Search Console — com moderação.

Quer a versão técnica — configuração, os métodos reais da API, cotas e as citações exatas do Google? Mude para a aba Avançado.

TL;DR — A API de Indexação é uma API REST autenticada pelo Google Cloud (v3) que aceita notificações URL_UPDATED e URL_DELETED. O Google a suporta oficialmente apenas para páginas JobPosting e BroadcastEvent-em-VideoObject (transmissão ao vivo) — não para conteúdo geral. Um 200 do endpoint de status confirma recebimento, não indexação. A postura do Google endureceu ao longo dos anos: 2022 (“não faz sentido”) → setembro de 2024 (um aviso de spam adicionado à documentação) → maio de 2025 (Mueller: “spammers usam mal a API de Indexação… use-a corretamente, ou não a use”). Uso indevido, incluindo múltiplas contas para inflar a cota, pode ter o acesso revogado. Para páginas gerais, suas alavancas são sitemaps, links internos, qualidade e ocasional “Request indexing” do GSC — e lembre-se de que o Google não suporta IndexNow.

O que a API de Indexação realmente é

A API de Indexação é um canal de envio programático: uma API REST (v3), autenticada por meio de uma conta de serviço do Google Cloud, que você chama para informar ao Google que uma URL foi adicionada/atualizada (URL_UPDATED) ou deve ser removida (URL_DELETED). Ela fica ao lado dos sitemaps e do Search Console como uma forma de o Google descobrir e atualizar URLs — mas é a mais restrita de todas em termos de tipo de conteúdo.

Na minha apresentação How Search Works, listo a API de Indexação como uma fonte de descoberta de URL com o rótulo “casos de uso limitados” — o que resume tudo em duas palavras. Ela é real, funciona e só é permitida para uma fração da web.

Para o que o Google oficialmente a suporta

Este é o fato essencial, então vou afirmá-lo como o Google faz. A API de Indexação “só pode ser usada para rastrear páginas com JobPosting ou BroadcastEvent incorporados em um VideoObject.” É isso — dois tipos de dados estruturados:

• JobPosting — páginas de listagem de empregos. Elas expiram, e empregos desatualizados são uma má experiência do usuário, então a adição/remoção em tempo hábil é importante.
• BroadcastEvent em um VideoObject — páginas de eventos ao vivo. Elas só são relevantes durante (e logo em torno) da transmissão.

Por que apenas esses dois? Ambos são inerentemente sensíveis ao tempo e de curta duração. A justificativa que o Google dá é que a notificação rápida de mudanças é muito mais importante para estes do que para páginas perenes, que o rastreamento normal lida bem.

Como funciona

Pré-requisitos

A configuração não é trivial — este não é um recurso de um clique:

• Um projeto do Google Cloud com a API de Indexação ativada. Como o Google diz, você “precisa informar ao Google sobre seu cliente e ativar o acesso à API.”
• Uma conta de serviço com um arquivo de chave JSON, armazenado com segurança.
• Verificação no Search Console do site e, em seguida, adicione sua conta de serviço como proprietário delegado do site.
• OAuth: “Toda chamada à API de Indexação deve ser autenticada com um token OAuth que você obtém em troca da sua chave privada,” usando o escopo https://www.googleapis.com/auth/indexing.

Os dois métodos (mais uma verificação de status)

• URL_UPDATED — “Para notificar o Google sobre uma nova URL para rastrear ou que o conteúdo em uma URL enviada anteriormente foi atualizado.” Envie por POST a URL com "type": "URL_UPDATED". Uma chamada bem-sucedida recebe um HTTP 200 — a própria redação do Google é que isso “significa que o Google pode tentar rastrear novamente esta URL em breve,” não que o fará, ou que o rastreamento resultará em indexação.
• URL_DELETED — antes de solicitar a remoção, o Google exige que “a URL deve retornar um código de status 404 ou 410 ou a página deve conter” uma tag meta noindex — é um ou/ou, não “exclua a página e também adicione noindex.” Uma vez que isso seja verdade, envie por POST a URL com "type": "URL_DELETED" para que o Google a remova.
• Status (GET) — retorna metadados (latest_update, latest_remove, notify_time). A ressalva crítica, textualmente: a solicitação GET “apenas retorna se você enviou uma solicitação com sucesso.” Ela não informa se o Google realmente indexou ou removeu algo.
• Loteamento — para reduzir conexões HTTP, você pode “combinar até 100 chamadas à API de Indexação em uma única solicitação HTTP.” A cota ainda é contada por URL: 10 solicitações em um lote ainda usam 10 solicitações da cota.

Cotas

A cota padrão do Google tem três dimensões separadas, não apenas um número:

• 200 solicitações de publicação/dia por projeto — cobre tanto chamadas URL_UPDATED quanto URL_DELETED combinadas. Este é o número que a maioria dos guias cita.
• 180 solicitações getMetadata (status)/minuto por projeto.
• 380 solicitações/minuto por projeto em todos os endpoints combinados.

Todos os três são descritos como “cota inicial padrão para teste” — ir além deles “exige aprovação adicional para uso e provisionamento de recursos,” por meio de um formulário de solicitação, e o Google observa “a cota pode aumentar ou diminuir com base na qualidade do documento.” O “truque” comum de criar várias contas de serviço ou projetos para inflar a cota diária é exatamente o que o Google proíbe (veja abaixo).

Você pode usá-la para páginas normais? O que o Google realmente diz

Resposta curta: não, não de forma suportada — e o Google tem sido notavelmente consistente e cada vez mais direto sobre isso.

A documentação traz um aviso de spam. Por volta de setembro de 2024, o Google adicionou linguagem ao quickstart tornando a postura explícita: “Todas as submissões através da Indexing API passam por detecção rigorosa de spam,” e “qualquer tentativa de abusar da Indexing API, incluindo o uso de múltiplas contas ou outros meios para exceder as cotas de uso, pode resultar na revogação do acesso.”

Os representantes disseram isso há anos. Em maio de 2022, John Mueller enquadrou isso com sua analogia de veículos de construção: a API “é destinada a tipos muito específicos de conteúdo,” e usá-la em outros lugares “não faz muito sentido.” Em maio de 2025, o tom estava mais afiado — Mueller: “Vemos muitos spammers usando mal a Indexing API assim, então eu recomendaria apenas seguir os casos de uso documentados e suportados,” e “Eu apenas usaria corretamente, ou não usaria. Se quiséssemos sugerir que as pessoas pudessem usá-la independentemente, documentaríamos assim.”

Esse arco — 2022 “não faz sentido” → 2024 aviso de spam na documentação → 2025 “spammers usam mal… use corretamente ou não use” — é um padrão de vários anos, não um caso isolado. A cobertura também observou que a API fica efetivamente inundada por blogueiros e profissionais de SEO que tratam sites normais como se fossem qualificados.

O risco real, declarado com precisão. Mueller não promete uma penalidade algorítmica. O enquadramento honesto é: não é suportado e vai contra as diretrizes, o conteúdo enviado de forma inadequada pode não permanecer indexado, e seu acesso pode ser revogado. Não exagere como uma ação manual garantida — mas também não finja que é gratuito.

O mito do endpoint de status

Este merece uma linha própria porque muitas ferramentas erram: uma submissão bem-sucedida é confirmação de recebimento, não uma promessa de indexação. O GET de status “apenas retorna se você enviou uma solicitação com sucesso.” Se um painel mostra um selo verde de “indexado” com base em um 200, ele está inferindo algo que a API nunca informou.

Indexing API vs Request Indexing vs IndexNow

Três coisas são confundidas constantemente. São mecanismos diferentes:

• Indexing API (Google): programática, mas com conteúdo restrito a JobPosting/BroadcastEvent. A mais restrita das três.
• Request Indexing (GSC URL Inspection): funciona para qualquer página que você possua, mas é manual, uma URL por vez, e destinada a uso ocasional — e é uma solicitação, não uma garantia.
• IndexNow: o protocolo aberto de envio entre mecanismos (Bing, Yandex, Yep, Seznam, Naver) — e o Google não o usa. É o análogo entre mecanismos da Indexing API, e é o que eu realmente defendo: ajudei a lançar a integração do IndexNow no Ahrefs Site Audit. Mas ele não alcança o Google.

(Detalhamento completo na aba Frameworks.)

O que fazer em vez disso para páginas gerais

Se você não está publicando vagas ou transmissões ao vivo, a Indexing API não é sua ferramenta, e o Google já disse isso repetidamente. Suas verdadeiras alavancas do Google são as pouco glamourosas:

• Sitemaps — para cobertura e descoberta.
• Links internos — páginas órfãs têm dificuldade; páginas linkadas são encontradas.
• Qualidade do conteúdo — o Google decide o que vale a pena indexar; páginas finas param em “Descoberta – atualmente não indexada”, não importa o quanto você as empurre.
• GSC “Request indexing” — para casos pontuais genuínos, com moderação.

Para envio entre mecanismos (Bing e afins, não Google), IndexNow é a ferramenta certa. E se você se importa com por que as páginas não estão sendo indexadas em primeiro lugar, isso é uma questão de frequência de rastreamento e qualidade, não uma questão de API.

Resumo de IA

Uma visão condensada da versão Avançada:

• O que é: uma API REST autenticada pelo Google Cloud (v3) para enviar notificações URL_UPDATED / URL_DELETED ao Google.
• O único fato que importa: oficialmente suportada apenas para páginas JobPosting e BroadcastEvent (transmissão ao vivo) — não para conteúdo geral. Ambos são sensíveis ao tempo por design.
• O mito nº 1: “indexa qualquer página rapidamente.” Não indexa; o Google chama o uso mais amplo de mau uso. Um envio bem-sucedido apenas confirma que o Google recebeu a solicitação, não que algo foi indexado.
• A posição do Google endureceu com o tempo: 2022 “não faz sentido” → setembro de 2024 aviso de spam adicionado à documentação → maio de 2025 Mueller “spammers usam mal… use corretamente, ou não use.”
• Risco: não suportado/contra as diretrizes; múltiplas contas para burlar a cota de ~200/dia podem ter o acesso revogado. Não é necessariamente uma penalidade manual — mas o conteúdo pode não permanecer.
• Não é o mesmo que IndexNow (entre mecanismos, Bing/Yandex/etc. — o Google não usa) ou GSC Request Indexing (qualquer página, manual, ocasional).
• Para páginas normais: sitemaps + links internos + qualidade + GSC Request Indexing ocasional.

Documentação oficial

Documentação de fonte primária do Google.

Google — Indexing API

• Indexing API Quickstart — a visão geral, a restrição JobPosting/BroadcastEvent e o aviso de detecção de spam.
• How to Use the Indexing API — os métodos URL_UPDATED / URL_DELETED e a ressalva do endpoint de status.
• Prerequisites — projeto Cloud, conta de serviço, escopo OAuth e propriedade delegada no Search Console.
• Quota and pricing — a cota padrão (200) e a aprovação necessária para mais.

Google — contexto para páginas gerais

• Ask Google to recrawl your URLs — sitemaps e o caminho “Request indexing” do Search Console para conteúdo normal.
• In-Depth Guide to How Google Search Works — onde a descoberta de URL e o pipeline rastrear → indexar → servir se encaixam.

Citações da fonte

Declarações registradas do Google. Cada link é um link profundo que salta para a passagem citada na página de origem.

Documentação do Google — a restrição

• “The Indexing API can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.” (tradução) «A Indexing API só pode ser usada para rastrear páginas com JobPosting ou BroadcastEvent incorporados em um VideoObject.» — Google Search Central, Indexing API Quickstart. Ir para a citação
• “The Indexing API allows site owners to directly notify Google when their job posting or livestreaming video pages are added or removed.” (tradução) «A Indexing API permite que os proprietários de sites notifiquem diretamente o Google quando suas páginas de vagas de emprego ou vídeos de transmissão ao vivo são adicionadas ou removidas.» Ir para a citação

Documentação do Google — o aviso de spam (adicionado à documentação por volta de setembro de 2024)

• “All submissions through the Indexing API undergo rigorous spam detection.” (tradução) «Todas as submissões por meio da API de indexação passam por uma rigorosa detecção de spam.» Ir para a citação
• “Any attempts to abuse the Indexing API, including the use of multiple accounts or other means to exceed usage quotas, may result in access being revoked.” (tradução) «Qualquer tentativa de abusar da API de indexação, incluindo o uso de várias contas ou outros meios para exceder as cotas de uso, pode resultar na revogação do acesso.» Ir para a citação

Documentação do Google — a ressalva do endpoint de status (mito desmascarado)

• “The GET request doesn’t tell you when Google indexes or removes a URL; it only returns whether you successfully submitted a request.” (tradução) «A solicitação GET não informa quando o Google indexa ou remove uma URL; ela apenas retorna se você enviou a solicitação com sucesso.» — Google Search Central, How to Use the Indexing API. Ir para a citação

Documentação do Google — cota

• “The default value is set to 200.” (solicitações de publicação/dia) (tradução) «O valor padrão é definido como 200.» — Google Search Central, quota & pricing. Ir para a citação
• “The default value is set to 180.” (solicitações de status getMetadata/minuto) e “The default value is set to 380.” (todos os endpoints/minuto) — as outras duas dimensões de cota que a maioria dos guias ignora. (tradução) «O valor padrão é definido como 180.» e «O valor padrão é definido como 380.» Ir para 180 · Ir para 380
• “The quota may increase or decrease based on the document quality.” (tradução) «A cota pode aumentar ou diminuir com base na qualidade do documento.» — Google Search Central, quota & pricing. Ir para a citação

Documentação do Google — agrupamento em lote e remoção

• “…you can combine up to 100 calls to the Indexing API into a single HTTP request.” (tradução) «…você pode combinar até 100 chamadas à API de indexação em uma única solicitação HTTP.» — Google Search Central, How to Use the Indexing API. Ir para a citação
• “…the URL must return a 404 or 410 status code or the page must contain” a noindex meta tag — before requesting removal. (tradução) «…a URL deve retornar um código de status 404 ou 410 ou a página deve conter» uma meta tag noindex — antes de solicitar a remoção. — Google Search Central, How to Use the Indexing API. Ir para a citação
• “An HTTP 200 response means that Google may try to recrawl this URL soon.” (tradução) «Uma resposta HTTP 200 significa que o Google pode tentar rastrear novamente esta URL em breve.» — Google Search Central, How to Use the Indexing API (sobre URL_UPDATED). Ir para a citação

John Mueller, Google Search Advocate — Bluesky, ~maio de 2025

• “We see a lot of spammers misuse the Indexing API like this, so I’d recommend just sticking to the documented & supported use-cases.” (tradução) «Vemos muitos spammers usando mal a API de indexação dessa forma, então eu recomendaria apenas seguir os casos de uso documentados e suportados.»
• “I’d just use it properly, or not use it. If we wanted to suggest that people could use it regardless, we’d document it as such.” (tradução) «Eu apenas usaria corretamente, ou não usaria. Se quiséssemos sugerir que as pessoas pudessem usá-la de qualquer forma, documentaríamos assim.» Leia a cobertura

John Mueller, Google — horário de atendimento de SEO, maio de 2022 (o enquadramento dos “veículos de construção”)

• “The indexing API is meant for very specific kinds of content. And using it for other kinds of content doesn’t really make sense.” (tradução) «A API de indexação é destinada a tipos muito específicos de conteúdo. E usá-la para outros tipos de conteúdo não faz muito sentido.»
• “It’s not that it’s illegal or that it will cause problems if you put construction vehicles on your medical website. But it doesn’t really make sense.” (tradução) «Não é que seja ilegal ou que cause problemas se você colocar veículos de construção no seu site médico. Mas não faz muito sentido.» Leia a cobertura

API de indexação — resumo

Casos de uso suportados (esta é a lista completa)

Os dois métodos

Agrupamento em lote: combine até 100 chamadas em uma única solicitação HTTP — a cota ainda é contada por URL, não por lote.

Fatos rápidos

• A cota padrão tem três partes: 200 solicitações de publicação/dia, 180 solicitações de status (getMetadata)/minuto, 380 solicitações/minuto em todos os endpoints. Cota além disso precisa da aprovação do Google e pode mudar com a qualidade do documento.
• 200 ≠ indexado. Uma resposta de sucesso confirma recebimento do envio, nada mais.
• Várias contas para burlar a cota = acesso revogado (de acordo com a documentação).
• Autenticação: projeto do Google Cloud + conta de serviço + OAuth, escopo https://www.googleapis.com/auth/indexing, conta de serviço adicionada como proprietário delegado do GSC.
• Não é IndexNow (entre mecanismos, não Google). Não é um substituto para sitemaps ou Solicitação de Indexação do GSC.

Uma chamada de publicação mínima (apenas para conteúdo suportado)

Esta é a forma de uma única notificação URL_UPDATED. Use apenas para páginas com dados estruturados JobPosting ou BroadcastEvent — é para isso que a API é autorizada. A etapa de autenticação (trocar a chave da sua conta de serviço por um token OAuth) é omitida por brevidade; na prática, você usaria uma biblioteca de cliente da API do Google para obter o token.

A solicitação

POST https://indexing.googleapis.com/v3/urlNotifications:publish
Authorization: Bearer <OAUTH_TOKEN>
Content-Type: application/json

{
  "url": "https://example.com/jobs/senior-seo-analyst",
  "type": "URL_UPDATED"
}

Para sinalizar uma remoção (depois que a página não existe mais ou está com noindex):

{
  "url": "https://example.com/jobs/senior-seo-analyst",
  "type": "URL_DELETED"
}

Verificando o status — observe que a resposta informa apenas que a solicitação foi recebida, não se algo foi indexado:

GET https://indexing.googleapis.com/v3/urlNotifications/metadata?url=https%3A%2F%2Fexample.com%2Fjobs%2Fsenior-seo-analyst
Authorization: Bearer <OAUTH_TOKEN>

Um 200 aqui significa “recebemos seu envio” — não é uma confirmação de que o Google indexou (ou removeu) a URL.

Agrupando várias URLs em lote: você pode combinar até 100 chamadas individuais em uma única solicitação HTTP multiparte para https://indexing.googleapis.com/batch em vez de disparar 100 solicitações separadas — mas a cota ainda é contada por URL, então um lote de 100 chamadas ainda usa 100 solicitações da sua cota diária. As bibliotecas de cliente da API do Google (Java, Python, JavaScript, PHP, .NET) lidam com a formatação do lote para você; fazer manualmente raramente vale a pena.

API de indexação vs Solicitação de Indexação vs IndexNow

O framework de decisão: descubra o que você tem e qual mecanismo você se importa, depois escolha o canal.

Como escolher

1. Tem vagas de emprego ou transmissões ao vivo e quer automatizar? → Indexing API.
2. Quer enviar páginas gerais para Bing/Yandex/Yep? → IndexNow.
3. Quer que o Google rastreie novamente uma página normal, uma vez? → GSC “Request indexing”.
4. Quer que páginas gerais sejam indexadas em escala no Google? → Não há botão mágico. Sitemaps + links internos + qualidade. (E paciência — veja frequência de rastreamento.)

O modelo mental: a Indexing API parece ser a mais poderosa das três porque é uma API, mas por tipo de conteúdo é a mais restrita. Poder e escopo não são a mesma coisa.

Ferramentas

• Google Cloud Console — crie o projeto, ative a Indexing API e gere a chave JSON da service account com a qual você fará a autenticação.
• Google Search Console — URL Inspection — para páginas normais, esta é a sua ferramenta real: verifique como uma URL foi rastreada/renderizada/indexada e use “Request indexing” para casos pontuais.
• Google Search Console — Sitemaps & Coverage — envie sitemaps e veja o que está indexado, “Discovered – currently not indexed” ou excluído.
• Bibliotecas de cliente da API do Google — a forma mais limpa de lidar com a troca de tokens OAuth para chamadas da Indexing API (em vez de implementar manualmente a assinatura JWT).
• Integração com IndexNow (Ahrefs Site Audit, etc.) — para o canal de envio entre mecanismos (Bing e outros, não Google). A ferramenta certa quando você quer o comportamento de envio programático que as pessoas desejam que a Indexing API oferecesse para páginas gerais.

Recursos que valem seu tempo

Meus artigos relacionados

• What Is Googlebot & How Does It Work? — onde a Indexing API se encaixa entre as fontes de descoberta de URLs do Google (links, sitemaps, RSS, GSC e a API).
• How to Fix “Discovered – currently not indexed” — a página real sobre “por que minhas páginas não indexam”; a solução é qualidade e links internos, não uma API de envio.
• The Beginner’s Guide to Technical SEO — onde rastreamento e indexação se encaixam no panorama geral.

Minhas palestras

• How Search Works (SlideShare) — minha explicação sobre descoberta, rastreamento, renderização, indexação e ranqueamento; o slide de descoberta de URLs marca a Indexing API como “casos de uso limitados”. (Meu aviso padrão se aplica: “This is my understanding of systems… not going to be 100% complete or accurate.”)

Sobre o IndexNow (o irmão multi-mecanismos — note que o Google não o usa)

• Integração do IndexNow no Site Audit da Ahrefs — o canal de push que eu realmente endosso, para Bing/Yandex/Yep em vez de Google.
• Como enviar páginas ao IndexNow dentro do Site Audit.

De outros

• Google Adds Spam Warning To Indexing API Documentation (Search Engine Journal, set. 2024) — documenta quando a linguagem de detecção de spam foi adicionada.
• Google Again Says Stop Using Indexing API For Unsupported Content (Search Engine Roundtable, maio 2025) — Barry Schwartz cobre o aviso de Mueller no Bluesky para parar de usar a API incorretamente.
• Misuse of Indexing API Could Lead to SEO Issues (StanVentures, maio 2025) — reproduz as citações de Mueller de maio de 2025 no Bluesky na íntegra e explica o risco de revogação de acesso.
• Google Answers Whether Using the Indexing API for a Normal Website Is Good or Bad (iLoveSEO, maio 2022) — transcrição do enquadramento de Mueller sobre “veículos de construção” no horário de expediente.
• Google Says Its Indexing API Is Inundated by Bloggers (Optimixed) — cobre como o uso fora do rótulo por blogueiros e profissionais de SEO sobrecarregou a API.
• r/TechSEO — a comunidade para depuração de rastreamento/indexação.

Problemas comuns

Problemas que as pessoas realmente enfrentam com a API de Indexação, na ordem sintoma → causa → correção.

”Recebi uma resposta 200, mas a página ainda não foi indexada”

• Sintoma: A chamada URL_UPDATED (ou o GET de status) retorna sucesso, mas a página nunca aparece na pesquisa, ou o Search Console ainda diz “Descoberta – atualmente não indexada.”
• Causa: Um 200 apenas confirma que o Google recebeu a notificação. De acordo com a própria documentação do Google, o endpoint de status “only returns whether you successfully submitted a request” — ele não informa se algo foi rastreado, indexado ou removido.
• Correção: Pare de tratar a resposta da API como confirmação de indexação. Verifique o status real de indexação na ferramenta Inspeção de URL no Search Console, ou no relatório de Cobertura. Se a página ainda não estiver indexada após uma espera razoável, o problema é de descoberta/qualidade (veja “O que fazer em vez disso” na aba Avançado), não da chamada à API.

”Meu acesso à API de Indexação foi revogado”

• Sintoma: Chamadas que funcionavam começam a falhar, ou o Google Cloud/Search Console mostra que o acesso da conta de serviço foi removido.
• Causa: O Google afirma claramente que “any attempts to abuse the Indexing API, including the use of multiple accounts or other means to exceed usage quotas, may result in access being revoked.” O gatilho mais comum é enviar páginas que não são JobPosting/BroadcastEvent, ou criar contas de serviço extras para contornar a cota padrão de ~200/dia.
• Correção: Audite o que você tem enviado — se for conteúdo geral (posts de blog, páginas de produto, qualquer coisa sem dados estruturados JobPosting ou BroadcastEvent), pare. A API não é documentada para suportar isso, e Mueller disse diretamente: “I’d just use it properly, or not use it.” Não há caminho de apelação documentado além de permanecer dentro do caso de uso suportado daqui em diante.

”Envios para páginas normais não parecem fazer nada”

• Sintoma: Você envia URL_UPDATED para um artigo comum ou página de produto e nada muda — sem rastreamento mais rápido, sem indexação mais rápida.
• Causa: O tipo de conteúdo não é um dos dois que o Google suporta. A Indexing API “só pode ser usada para rastrear páginas com JobPosting ou BroadcastEvent incorporados em um VideoObject.” Envios fora desse escopo não são um sinal documentado e suportado.
• Correção: Isso não é um bug para corrigir — é a ferramenta errada. Para páginas gerais, use um sitemap, links internos e (para casos pontuais ocasionais) “Request indexing” em URL Inspection do Search Console.

”Estou atingindo o limite de cota”

• Sintoma: Os envios começam a falhar ou a serem limitados — seja em torno de 200/dia, ou em rajadas mais curtas mesmo abaixo de 200/dia.
• Causa: O Google na verdade aplica três cotas padrão separadas: 200 solicitações de publicação (URL_UPDATED/URL_DELETED) por dia, 180 solicitações de status (getMetadata) por minuto e 380 solicitações por minuto em todos os endpoints combinados. Uma rajada de verificações de status pode limitar você nos limites por minuto bem antes de atingir os 200 diários. Ir além de qualquer um deles “exige aprovação adicional para uso e provisionamento de recursos,” e o Google observa que a cota concedida “pode aumentar ou diminuir com base na qualidade do documento.”
• Correção: Se você está legitimamente publicando/atualizando tantas páginas JobPosting ou BroadcastEvent por dia, solicite um aumento de cota pelo Google Cloud — não crie contas de serviço ou projetos extras para contornar isso, pois isso é explicitamente citado como o tipo de abuso que leva à revogação do acesso.

Listas de verificação

Antes de mexer na Indexing API

• Confirme se as páginas que você quer enviar realmente contêm dados estruturados JobPosting, ou BroadcastEvent incorporado em um VideoObject — os únicos dois tipos de conteúdo que o Google suporta.
• Se nenhum dos dois se aplica, pare aqui. Use sitemaps, links internos, qualidade de conteúdo e “Request indexing” ocasional no GSC — não a API.
• Decida se o seu volume de envios caberá realisticamente dentro da cota padrão de ~200/dia, ou se você precisará solicitar um aumento.

Configurando

• Crie (ou escolha) um projeto do Google Cloud e ative a Indexing API nele.
• Crie uma conta de serviço e baixe o arquivo de chave JSON; armazene-o com segurança (nunca o envie para um repositório público).
• Verifique seu site no Search Console se ainda não estiver.
• Adicione o e-mail da conta de serviço como proprietário de site delegado no Search Console.
• Confirme que você consegue trocar a chave da conta de serviço por um token OAuth com o escopo https://www.googleapis.com/auth/indexing (normalmente via uma biblioteca de cliente da API do Google em vez de assinatura JWT feita à mão).

Enviando uma notificação

• Escolha o método certo: URL_UPDATED para uma página suportada nova ou alterada, URL_DELETED depois que a página for removida ou tiver noindex.
• Envie a URL com o campo type correto para https://indexing.googleapis.com/v3/urlNotifications:publish.
• Trate uma resposta 200 como confirmação de recebimento apenas — não como prova de que a página foi indexada ou removida.
• Acompanhe no Search Console (URL Inspection ou Coverage) se você precisar confirmar o status real de indexação.

Permanecendo dentro das diretrizes

• Envie apenas páginas JobPosting/BroadcastEvent por esta API — nada mais.
• Não crie várias contas de serviço ou projetos apenas para exceder a cota; solicite um aumento legítimo.
• Se você não tem certeza se uma página se qualifica, trate como “não se qualifica” e use sitemaps/links internos/Request indexing para ela.

Quiz

Cinco perguntas para verificar o que realmente ficou sobre a Indexing API.

Registro de alterações