A Content API for Shopping do Google foi descontinuada em 18 de agosto de 2026. Desde 1º de setembro, as requisições de projetos sem uma extensão aprovada vêm falhando de forma intermitente com HTTP 410, e os endpoints serão desligados completamente no início de 2027 (aviso de descontinuação do Google). Se um script, plugin ou conector interno ainda envia seus produtos ao Merchant Center pela API antiga, parte dessas atualizações já está sendo descartada.
Este guia é para desenvolvedores e responsáveis por feeds que mantêm esse pipeline por conta própria. Ao final, você será capaz de encontrar todas as chamadas restantes à Content API, mapear cada uma para seu equivalente na Merchant API, criar a fonte de dados que a nova API exige e confirmar no Merchant Center que produtos e preços continuam chegando.
Como saber se você está sendo afetado pela descontinuação
A falha é fácil de passar despercebida porque é intermitente. O Google documenta o corpo do erro como um 410 com uma mensagem que começa com "Content API for Shopping was sunset on August 18, 2026" e inclui o ID do seu projeto no Google Cloud, o número do projeto e um link para a central de ajuda. Procure essa string e shoppingcontent.googleapis.com nos logs da sua integração.
Três sintomas costumam aparecer antes que alguém leia um log:
- Alterações de preço ou disponibilidade chegam ao Google com horas de atraso, ou apenas em algumas execuções.
- Um job diário informa sucesso na maioria dos lotes e falha em alguns.
- O Merchant Center mostra dados desatualizados enquanto sua loja mostra o preço correto.
O último sintoma tem uma segunda causa possível: as atualizações automáticas de itens do próprio Google sobrescrevendo seus valores. Abordamos isso separadamente em como impedir que o Google sobrescreva silenciosamente o preço e a disponibilidade do seu feed. Descarte primeiro os erros 410, porque eles são mais fáceis de confirmar.
Passo 1: faça um inventário de todos os chamadores da API antiga
A orientação do próprio Google é revisar o código da sua aplicação em busca de chamadas diretas aos endpoints da Content API. Na prática, as chamadas se escondem em quatro lugares: o plugin do Google da plataforma da loja, um script personalizado escrito por um desenvolvedor anterior, um middleware de feed ou ERP e um script do Google Ads ou Apps Script que alguém programou anos atrás.
Monte um registro curto, com uma linha por chamador. Anote o que ele faz, com qual projeto do Google Cloud ele se autentica e quem é o responsável. O ID do projeto importa porque as extensões e a mensagem do erro 410 estão vinculadas a ele.
| Chamador | O que envia | Responsável | Ação |
|---|---|---|---|
| Plugin da loja | Catálogo completo, diariamente | Fornecedor da plataforma | Perguntar qual versão da API ele usa agora |
| Script de estoque | Preço e estoque, a cada hora | Seu desenvolvedor | Migrar para a Merchant API |
| Ferramenta de gestão de feeds | Feed otimizado | Fornecedor da ferramenta | Pedir confirmação da migração por escrito |
Se um fornecedor gerencia a conexão, seu trabalho é perguntar, não reconstruir. A Productsup e a Feedonomics publicaram materiais sobre a migração, e um fornecedor maduro já terá migrado. Faça a mesma pergunta a todos os fornecedores da sua lista e guarde as respostas.
Passo 2: decida se você precisa de uma extensão
O Google oferece um formulário de solicitação de extensão da Content API para organizações que precisam de mais tempo. Extensões aprovadas protegem um projeto das respostas de erro programadas durante a janela aprovada, e não vão além da desativação final no início de 2027. O Google não informa quem se qualifica.
Use esta regra de decisão. Se todos os chamadores puderem ser migrados e testados em poucas semanas, dispense a extensão e invista o tempo na migração. Se um chamador pertencer a um fornecedor com migração confirmada, mas sem data, solicite uma extensão apenas para esse projeto. Uma extensão é uma margem de segurança, não um plano.
Passo 3: mapeie cada chamada para seu equivalente na Merchant API
A Merchant API divide o antigo monólito em sub-APIs e versiona a URL (/products/v1/). A versão v1 ficou disponível de forma geral em julho de 2025 e a v1beta foi descontinuada em 28 de fevereiro de 2026; portanto, desenvolva com base na v1 e ignore os tutoriais da v1beta que encontrar (notas de versão da Merchant API).
| Content API | Merchant API | O que muda |
|---|---|---|
products.insert | productInputs.insert | Exige um parâmetro de consulta dataSource |
products.update | productInputs.patch | Atualização persistente de um product input |
products.delete | productInputs.delete | Exige um parâmetro dataSource |
products.get / list | products.get / list | Retorna o produto processado, somente leitura |
productstatuses.get / list | products.get / list | O status agora faz parte do recurso Product |
custombatch | Chamadas assíncronas em paralelo | Não existe método customBatch |
datafeeds | dataSources | Cada fonte de dados atende a um único feed label e idioma |
Fonte: mapeamento de migração de produtos e mapeamento de fontes de dados do Google. A mudança conceitual é a separação entre um ProductInput, que são os dados brutos que você grava, e um Product, que é o resultado processado que você só pode ler. Um produto processado é montado a partir de um input principal mais quaisquer inputs suplementares, depois que as regras de feed são executadas (visão geral de produtos).
Passo 4: crie a fonte de dados da API antes de inserir qualquer coisa
Esta é a etapa que quebra a maioria das primeiras migrações. A Content API criava automaticamente uma fonte de dados "Content API" na sua primeira inserção. A Merchant API não faz isso. O Google afirma que você precisa criar pelo menos uma fonte de dados do tipo API e que a sub-API Products só consegue gravar em fontes de dados desse tipo (migração de fontes de dados).
Agora, cada fonte de dados corresponde a uma única combinação de feedLabel e contentLanguage. Se você atendia a Turquia em turco e os Emirados Árabes Unidos em inglês a partir de um único feed com vários destinos, agora precisa de fontes de dados separadas. Crie-as pela sub-API Data Sources ou no Merchant Center e, em seguida, use o nome de recurso resultante, no formato accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}, em todas as gravações.
Passo 5: reescreva o payload, com um exemplo prático
Três mudanças de campo causam a maioria dos bugs. O preço deixa de ser uma string decimal e passa a ser um inteiro em micros, em que um milhão de micros equivale a uma unidade da moeda. Os atributos do produto passam para um objeto productAttributes. E targetCountry é substituído por feedLabel, enquanto channel deixa de existir.
O identificador de produto antigo tinha esta forma, e o novo usa tils e descarta o canal:
Content API: online:en:US:SKU12345
Merchant API: en~US~SKU12345
Um product input que o próprio guia do Google usa como exemplo tem esta forma (inserção com POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}):
{
"offerId": "SKU12345",
"contentLanguage": "en",
"feedLabel": "US",
"productAttributes": {
"title": "Classic Cotton T-Shirt",
"link": "https://www.example.com/p/SKU12345",
"imageLink": "https://www.example.com/img/SKU12345.jpg",
"availability": "IN_STOCK",
"price": { "amountMicros": "15990000", "currencyCode": "USD" },
"condition": "NEW",
"gtins": ["9780007350896"]
}
}
Compare com o formato antigo: "price": {"value": "15.99", "currency": "USD"} passa a usar amountMicros e currencyCode, e a disponibilidade vira um enum, então in stock passa a ser IN_STOCK. Fonte: guia do Google para adicionar e gerenciar produtos.
Para a lira turca, 1.249,90 TRY corresponde a "amountMicros": "1249900000". Calcule os micros com aritmética de inteiros sobre a menor unidade da moeda, e não multiplicando um float, ou você vai enviar 1249899999 e se perguntar por que os preços diferem por um fio.
Use também o novo campo versionNumber quando vários jobs gravarem o mesmo produto. Ele impede que uma atualização mais antiga sobrescreva uma mais recente quando as requisições chegam fora de ordem.
Passo 6: substitua o processamento em lote e leia o status a partir do produto
Não existe customBatch. Substitua-o por requisições assíncronas em paralelo, limite a concorrência e tente novamente apenas as que falharem. Mantenha um log de resultados por oferta, para que uma falha parcial não se transforme silenciosamente em um catálogo desatualizado.
Para o status, pare de chamar productstatuses. Leia o Product processado, que traz o seu status. O Google observa que pode haver um atraso de alguns minutos entre uma inserção ou atualização e a disponibilização do produto final; portanto, uma leitura imediatamente após uma gravação não serve como teste de falha.
Passo 7: verifique antes de desligar o caminho antigo
Execute primeiro o novo caminho em uma pequena fatia de baixo risco, como 50 produtos em um feed label. Depois, avalie a transição com esta checklist. Todas as linhas devem ser "sim" antes de você aposentar o chamador antigo.
- O chamador se autentica no projeto que você registrou e não retorna nenhum 410 por sete dias consecutivos.
- Existe uma fonte de dados de API para cada par de feed label e idioma que você atende.
- Na fatia de teste, o produto processado corresponde à sua fonte de verdade em preço, disponibilidade e link.
- Nada mais continua gravando os mesmos IDs de oferta a partir da fonte de dados antiga.
- As ofertas com falha são registradas com nova tentativa, e não descartadas.
- Todos os chamadores gerenciados por fornecedores no seu registro têm uma confirmação de migração por escrito.
O quarto item merece atenção. Um segundo gravador para o mesmo ID de oferta, por exemplo o chamador antigo e uma nova fonte de dados de API, é o que gera valores conflitantes. Decida qual fonte é dona de cada produto e remova a outra.
Onde este guia tem limites
Escrevemos este guia com base na documentação publicada pelo Google e não migramos o seu código. Várias coisas ficam de fora. O Google não informa os critérios de elegibilidade para extensões, então não podemos dizer se um determinado projeto será aprovado. A visão geral de produtos não documenta prazos além de "alguns minutos", então qualquer expectativa de latência mais rigorosa precisa ser medida por você. Inventário local, inventário regional, promoções e avaliações têm cada um seus próprios sub-recursos na Merchant API, e não abordamos esses mapeamentos aqui.
Se você não quer ser responsável por uma integração de API, uma plataforma gerenciada de feeds é uma resposta melhor do que uma reescrita. A Productsup e a Feedonomics publicam orientações de migração para a Merchant API e, para uma equipe enterprise com modelos de dados incomuns, qualquer uma delas pode se encaixar melhor do que a nossa solução. Especificamente para o Google Shopping, nossa solução está descrita na página de integração com o Google Merchant Center.
Perguntas frequentes
A Content API for Shopping ainda funciona?
Não de forma confiável. O Google afirma que ela foi descontinuada em 18 de agosto de 2026, que as requisições sem uma extensão ativa começaram a falhar de forma intermitente com HTTP 410 a partir de 1º de setembro de 2026 e que todos os endpoints serão desligados no início de 2027.
O que diz o erro 410 da Content API?
A mensagem começa com "Content API for Shopping was sunset on August 18, 2026". A resposta inclui o ID do seu projeto no GCP, o número do projeto e um link para a central de ajuda, o que indica qual projeto migrar ou estender.
Posso ganhar mais tempo com uma extensão?
O Google disponibiliza um formulário de solicitação de extensão da Content API. Extensões aprovadas protegem seu projeto dos erros programados apenas durante a janela aprovada e não vão além da desativação no início de 2027.
Por que o productInputs.insert pede um dataSource?
As gravações na Merchant API pertencem a uma fonte de dados explícita. Diferentemente da API antiga, ela não cria uma fonte de dados "Content API" na sua primeira inserção, então você precisa criar uma fonte de dados do tipo API e informar o nome do recurso.
Como envio preços na Merchant API?
Use amountMicros como uma string de inteiro e currencyCode no formato ISO 4217. Um milhão de micros equivale a uma unidade da moeda, então 15,99 USD corresponde a 15990000.
A Merchant API oferece processamento em lote?
Não existe o método customBatch. A orientação do Google é usar chamadas assíncronas em paralelo, o que significa que você deve adicionar seu próprio limite de concorrência e novas tentativas por oferta.
Para onde foi o productstatuses?
O status agora faz parte do recurso Product processado. Use products.get ou products.list para lê-lo, lembrando que o processamento pode levar alguns minutos após uma inserção.
Em qual versão da Merchant API devo desenvolver?
Desenvolva com base na v1, que ficou disponível de forma geral em julho de 2025. A versão v1beta foi descontinuada em 28 de fevereiro de 2026, então os tutoriais escritos para ela vão falhar.
Confira o que o Google realmente vê
Depois da migração, a verificação mais rápida é comparar seu feed de origem com o que o Merchant Center processou. Passe seu feed ativo pela nossa ferramenta gratuita de auditoria de feed de produtos para obter uma pontuação de completude e qualidade, e corrija o que ela apontar antes do próximo ciclo de anúncios.

Cofundador da Feedance, onde aproveita sua formação como engenheiro de computação e profissional de marketing para gerar insights analíticos. Com um forte foco em transformar dados em estratégias acionáveis, ele se dedica a ajudar marcas a alcançar um crescimento significativo no cenário digital.
LinkedIn


















