Migração WooCommerce para Merchant API
PT-PT

Migração WooCommerce para Merchant API

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

A Google vai desligar a Content API for Shopping a 18 de agosto de 2026. A partir dessa data, cada chamada aos antigos endpoints v2.1 volta como HTTP 410 Gone, e qualquer integração ainda apontada para eles deixa 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 ignora, é que uma grande parte das lojas WooCommerce não tem nada a fazer.

A versão honesta desta história é uma triagem, não uma emergência. Na WPPoland construímos e mantemos integrações WooCommerce para comerciantes que vendem em toda a UE, por isso aqui fica quem é realmente afetado, o que deixa de funcionar se falharem a data e porque é que a mesma migração é, discretamente, a porta para o comércio conduzido por agentes.


#O que está a mudar, 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. Está a ser substituída pela mais recente 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 importa é 18 de agosto de 2026. A partir daí, a antiga Content API devolve 410 Gone e não volta. Há também uma data anterior: a v1beta da Merchant API é descontinuada a 28 de fevereiro de 2026, por isso qualquer código escrito contra a beta tem de estar na v1 estável bastante antes do prazo principal.

#Precisa mesmo de fazer alguma coisa? Depende de como o feed 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 Google e o WooCommerce entregam a passagem para a Merchant API dentro de uma versão do plugin antes do prazo, por isso uma atualização normal leva-o para o outro lado sem tempo de inatividade e sem código. Mantenha o plugin atualizado e está tudo tratado.
  • Um plugin de feed ou de marketing de terceiros. Alguns destes chamam a Content API diretamente. Confirme com o fornecedor que uma atualização para a Merchant API está a caminho e que está na versão que a inclui.
  • 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 exatamente o tipo de construção que as agências montam para lojas maiores ou fora do padrão.

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 deixa de funcionar se uma integração própria falhar o prazo

Nada se degrada com suavidade. A 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, a suposição segura é que uma integração própria tem de ser migrada e testada bastante antes de agosto, não em cima do prazo.

#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.

  • 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 prazo à 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 tem de fazer de qualquer forma é, 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 esta semana

Se usa o plugin oficial, anote o prazo, mantenha o plugin atualizado e siga com o seu dia. Se tem uma integração própria ou de terceiros, descubra de que sub-APIs depende e agende a migração com margem suficiente para testar 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: 20 de julho 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.

Quando é que a Content API for Shopping deixa de funcionar?#
A 18 de agosto de 2026. A partir dessa data, as chamadas aos endpoints v2.1 da Content API devolvem HTTP 410 Gone, portanto qualquer integração que ainda a use deixa 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 Google e o WooCommerce entregam a passagem para a Merchant API dentro de uma versão do Google for WooCommerce antes do prazo, por isso manter o plugin atualizado leva-o para o outro lado sem tempo de inatividade. O trabalho 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?#
Migre-a para a Merchant API antes de 18 de agosto de 2026. Mapeie cada chamada da Content API para a sub-API correspondente da Merchant API (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.