Migração WooCommerce para Merchant API
PT-PT

Migração WooCommerce para Merchant API

Última verificação: 20 de agosto de 2026
7 min de leitura
Guia
Especialista WooCommerce

A Google desligou a Content API for Shopping a 18 de agosto de 2026. Desde então, cada chamada aos antigos endpoints v2.1 volta como HTTP 410 Gone, e qualquer integração ainda apontada para eles deixou de enviar produtos, preços e stock para o Google Merchant Center. A boa notícia, que a maioria das publicações em pânico ignorou, é que uma grande parte das lojas WooCommerce não teve nada a fazer. Se a sua está nesse grupo, o feed continua a correr; se não está, aqui fica como confirmar e o que fazer agora.

A versão honesta desta história continua a ser uma triagem, não um pânico. Na WPPoland construímos e mantemos integrações WooCommerce para comerciantes que vendem em toda a UE, por isso aqui fica quem foi realmente afetado, o que deixou de funcionar para quem falhou a data e porque é que a mesma migração é, discretamente, a porta para o comércio conduzido por agentes.


#O que mudou, e quando?

A Content API for Shopping é a antiga superfície programática da Google para gerir tudo o que uma loja envia para o Merchant Center: dados de produtos, stock, preços e definições de conta. Foi substituída pela Merchant API, que cobre o mesmo terreno, mas está dividida em sub-APIs focadas (Products, Inventories, Accounts, Reports) em vez de um endpoint monolítico.

A data que importou foi 18 de agosto de 2026. Desde aí, a antiga Content API devolve 410 Gone e não volta. Houve também uma data anterior: a v1beta da Merchant API foi descontinuada a 28 de fevereiro de 2026, por isso qualquer código escrito contra a beta já tinha de estar na v1 estável antes do corte principal.

#O seu feed ainda sincroniza? Depende de como está ligado

Esta é a pergunta que decide se pode fechar este separador. Uma loja WooCommerce costuma falar com o Merchant Center de três formas.

  • O plugin oficial Google for WooCommerce. Se a sincronização de produtos corre através do plugin oficial (antigo Google Listings and Ads), está protegida. A passagem para a Merchant API foi entregue dentro de uma versão do plugin, por isso quem foi atualizando atravessou a data sem tempo de inatividade e sem código. Confirme na mesma que está numa versão recente e que a última sincronização de produtos é posterior a 18 de agosto.
  • Um plugin de feed ou de marketing de terceiros. Alguns destes chamavam a Content API diretamente. Confirme com o fornecedor que a atualização para a Merchant API já saiu, que a tem instalada e que o feed voltou a atualizar depois de 18 de agosto.
  • Uma integração própria. Conectores à medida, exportadores de feed próprios, configurações headless que enviam para o Merchant Center a partir do seu próprio código e ferramentas internas escritas contra a Content API. É este o grupo com trabalho real, e se esse código nunca mudou de API está agora a receber 410 Gone a cada tentativa.

No mercado português junta-se aqui um caso típico: uma loja que, com um único exportador próprio, alimenta ao mesmo tempo o Google Merchant Center e o KuantoKusta. A Google é então apenas um de vários canais nesse script, por isso a migração desse único ramo para a Merchant API tem de acontecer sem mexer nos restantes feeds, que continuam a funcionar como antes.

Se está no primeiro grupo, pare por aqui. Se está no terceiro, continue a ler.

#O que deixou de funcionar nas integrações que ficaram para trás

Nada se degradou com suavidade. Desde 19 de agosto de 2026 as chamadas simplesmente falham com 410 Gone, e os efeitos alastram em cascata:

  • As listagens ficam desatualizadas. Os produtos novos deixam de aparecer, e os removidos podem ficar pendurados. O seu catálogo no Merchant Center afasta-se do seu catálogo real do WooCommerce.
  • Preços e stock deixam de atualizar. Este é o perigoso. O Merchant Center continua a mostrar o último preço e a última disponibilidade que recebeu, por isso pode acabar a anunciar um preço que já não pratica ou um produto que já não tem em stock, o que arrisca reprovações e perda de confiança da conta.
  • As campanhas Shopping e Performance Max passam fome. As campanhas do Google Ads alimentam-se dos dados de produtos do Merchant Center. Quando o feed congela, as campanhas correm sobre stock desatualizado até começarem, discretamente, a ter mau desempenho.

Como falha tudo de uma vez em vez de o avisar, um feed parado pode passar dias despercebido. Se não sabe ao certo em que grupo está, verifique agora: no Merchant Center veja a data do último processamento do feed, e do lado da loja veja o registo de erros da integração. Uma resposta 410 nesses registos fecha a questão.

#Uma checklist de migração para integrações WooCommerce próprias

O trabalho é metódico, não difícil, e é engenharia WooCommerce comum do lado do servidor.

  • Confirme primeiro que a causa é mesmo a Content API. Procure nos registos da loja as respostas 410 e o domínio shoppingcontent.googleapis.com. Se aparecer, a integração continua a chamar a superfície antiga e é essa a origem do feed congelado.
  • Inventarie as suas chamadas da Content API. Liste cada endpoint que a integração toca e o evento WooCommerce que o dispara (gravação de produto, alteração de stock, sincronização completa agendada).
  • Mapeie cada chamada para a respetiva sub-API da Merchant API. Products, Inventories, Accounts e Reports assumem, cada uma, parte do que a Content API fazia num só sítio.
  • Volte a autenticar-se. A Merchant API usa OAuth 2.0 ou uma conta de serviço. Confirme que as suas credenciais e âmbitos transitam.
  • Verifique as etiquetas do feed após a mudança. A configuração das etiquetas nem sempre sobrevive à passagem, e as etiquetas comandam a estrutura das campanhas, por isso verifique-as em vez de assumir.
  • Obtenha os motivos de reprovação agregados a partir da sub-API Reports assim que a nova integração estiver a funcionar, para apanhar tudo o que a mudança alterou antes de os algoritmos da Google o fazerem.

#O ganho que ninguém põe na fatura

Encarar a migração como uma tarefa maçadora falha o essencial. A passagem para a Merchant API abre também o Merchant API MCP Access Service, uma ponte alpha que expõe os dados do Merchant Center a LLMs e agentes de IA através do Model Context Protocol, por agora apenas leitura mais algumas ferramentas de escrita de baixo risco. Em linguagem simples: a mesma plataforma onde o seu feed de produtos agora vive é aquela a partir da qual os assistentes de compras de IA vão ler quando decidirem que produtos mostrar.

Isto liga o corte à mudança maior sobre a qual temos escrito: as lojas passam de serem navegadas por pessoas a serem consultadas por agentes. A migração que já não pode adiar é, ao mesmo tempo, a rampa de acesso para ser encontrável e comprável por esses agentes, que é toda a tese do nosso guia de preparação para o comércio de IA.

#O que fazer agora

Se usa o plugin oficial, confirme que está numa versão recente e que o feed atualizou depois de 18 de agosto, e siga com o seu dia. Se tem uma integração própria ou de terceiros e o feed parou, descubra de que sub-APIs depende e faça a migração já, testando primeiro contra uma conta não produtiva, porque é exatamente isso que a Google recomenda antes de encaminhar tráfego de produção para as novas ferramentas.

Tratamos destas migrações no âmbito do nosso trabalho de desenvolvimento WooCommerce, a par do lado analítico das encomendas conduzidas por agentes, que abordamos em o que acontece quando um agente de IA finaliza a compra, e do servidor MCP para WooCommerce apenas de leitura, que mostra como os agentes leem um catálogo, para começar.

Última atualização: 19 de agosto de 2026.

Próximo passo

Transforme o artigo numa implementação real

Este bloco reforça a ligação interna e conduz o leitor para o passo seguinte mais útil dentro da arquitetura do site.

Cluster relacionado

Explorar outros serviços WordPress e base de conhecimento

Reforce o seu negócio com suporte técnico profissional em áreas-chave do ecossistema WordPress.

A Content API for Shopping ainda funciona?#
Não. Foi desligada a 18 de agosto de 2026. As chamadas aos endpoints v2.1 da Content API devolvem HTTP 410 Gone, portanto qualquer integração que ainda aponte para lá deixou de sincronizar produtos, preços e stock com o Merchant Center.
Uso o plugin oficial Google for WooCommerce. Tenho de fazer alguma coisa?#
Sem migração manual. A passagem para a Merchant API foi entregue dentro de uma versão do Google for WooCommerce, por isso quem manteve o plugin atualizado atravessou a data sem tempo de inatividade. Confirme na mesma que está numa versão recente e que a sincronização de produtos continua a correr. O trabalho manual recai apenas sobre lojas com integrações próprias ou de terceiros à Content API.
O que faço se a minha loja tiver uma integração própria com o Merchant Center?#
Comece por confirmar o estado: se as chamadas devolvem 410 Gone, o feed já parou e o catálogo no Merchant Center está congelado no último envio bem-sucedido. Depois migre para a Merchant API, mapeando cada chamada da Content API para a sub-API correspondente (Products, Inventories, Accounts, Reports), volte a autenticar-se com OAuth 2.0 ou uma conta de serviço e reverifique etiquetas e reprovações após a mudança, porque a configuração das etiquetas nem sempre transita.
A Merchant API serve só para manter tudo a funcionar?#
Não. Abre também o Merchant API MCP Access Service, que permite aos agentes de IA ler os dados do Merchant Center através do Model Context Protocol. A mesma migração que mantém as suas listagens vivas é também a porta de entrada para o comércio conduzido por agentes, em que os assistentes de IA encontram e recomendam os seus produtos.

Precisa de FAQ adaptado ao setor e mercado? Criamos uma versão alinhada com os seus objetivos de negócio.

Fale connosco

Artigos Relacionados

Analítica de checkout de agentes WooCommerce

Os agentes de IA colocam encomendas no WooCommerce do lado do servidor, por isso os pixels do navegador em que o seu relatório assenta nunca disparam. O que se avaria, porque a Conversions API não é um resgate automático e como instrumentar corretamente o checkout do agente.