Durante anos, enviar avaliações de produto para o Google foi um trabalho de arquivo. Você montava um XML, agendava uma busca automática e torcia para que nada quebrasse no meio do caminho. A documentação oficial era explícita ao dizer que a API não valia para esse tipo de dado, e quem operava catálogos grandes conviveu com essa limitação como se fosse parte da paisagem.
Isso mudou em setembro de 2026. O Google atualizou a documentação de avaliações de produto e passou a listar o envio por API como método disponível, apontando para a Merchant API para avaliações de produto. A mudança foi notada primeiro por Barry Schwartz, no Search Engine Roundtable, e detalhada em seguida pela Search Engine Land.
Parece um ajuste pequeno de documentação. Na prática, fecha uma lacuna importante: o canal de avaliações era o último pedaço relevante do Merchant Center que ainda dependia de arquivo, justamente enquanto o resto da operação migrava para a nova API.
O que exatamente mudou na documentação
A comparação entre as duas versões do documento de ajuda é direta. Onde antes se lia que a API não era compatível com fontes de dados de avaliações de produto, agora existe a opção de adicionar avaliações usando API, com link para o guia da Merchant API.
| Item | Versão anterior | Versão atual |
|---|---|---|
| Envio por API | Declarado como não compatível | Compatível pela Merchant API |
| Caminho na interface | ANALYTICS, Reviews, Product reviews, Product review data sources | Produtos e loja, Avaliações, Avaliações do produto, Gerenciar fontes |
| Onboarding | Instruções ligadas ao Merchant Center antigo | Instruções alinhadas ao Merchant Center Next |
| Reprovações por política | Tratadas de forma genérica | Seção esclarecida no novo documento |
O Google também atualizou a navegação e o processo de entrada no programa, refletindo o layout do Merchant Center Next. Quem ainda procura o caminho antigo no menu não vai encontrar.
Como o envio pela Merchant API funciona
A lógica é a mesma de qualquer outro recurso da Merchant API: você chama o endpoint de avaliações de produto e envia os dados diretamente, sem depender de um arquivo hospedado e de uma janela de busca automática. O Google mantém uma rota equivalente para avaliações do vendedor, o que permite tratar os dois tipos de reputação pelo mesmo caminho técnico.
Esse é o mesmo movimento que já levou o catálogo inteiro para a nova interface programática. Se você acompanhou o encerramento da Content API for Shopping, reconhece o padrão: o Google concentra tudo na Merchant API e vai aposentando os caminhos antigos um a um.
Os pré-requisitos que não mudaram
Vale insistir neste ponto, porque é onde a maioria das equipes trava. A API abre o canal de envio, não a elegibilidade. A documentação oficial é clara sobre o que precisa estar em pé antes:
- Um feed de avaliações de produtos ativo no Merchant Center.
- A conta inscrita no programa de classificações do produto.
- A verificação de qualificação, que pode ser feita pela sub-API Programs ou pela própria interface.
Ou seja: contas que nunca entraram no programa continuam de fora, e a chamada de API não vai contornar isso. O ganho está na automação de quem já é elegível, não em um atalho de entrada.
As avaliações de produtos são uma parte importante da experiência de compra dos clientes. Essas classificações e avaliações ajudam os clientes na pesquisa de produtos e nas decisões de compra.
Documentação oficial da Merchant API, Google for Developers
Por que isso importa mais agora do que importaria há dois anos
O peso da avaliação estruturada cresceu junto com a busca com IA. Quando o Google abriu os dados de desempenho da busca com IA dentro do Merchant Center, ficou evidente que a ficha do produto virou a unidade de informação que alimenta as respostas geradas. Reputação desatualizada no feed passou a ser um problema de visibilidade, não apenas de vitrine.
O mesmo vale fora do Google. Quando o ChatGPT Shopping passou a decidir pelo feed e não pela web, o dado estruturado virou a fonte primária de recomendação. Avaliação que chega com uma semana de atraso é avaliação que não entrou na conversa.
Some a isso o endurecimento das regras de conteúdo. O Google já havia proibido avaliações falsas e incentivadas no schema de avaliações, e o documento novo mantém uma seção dedicada a reprovações por política. Automatizar o envio sem revisar a origem das avaliações apenas acelera o caminho até a reprovação.
O que isso muda na rotina de quem opera catálogo
| Situação | Antes | Com a API |
|---|---|---|
| Loja com poucos SKUs | Arquivo manual resolve | Arquivo continua viável |
| Catálogo grande e volátil | Busca agendada, atraso de horas | Envio sob demanda, próximo do tempo real |
| Plataforma que atende várias lojas | Um arquivo por cliente | Uma integração, várias contas |
| Correção de avaliação removida | Espera o próximo ciclo do feed | Atualização pontual no registro |
Para lojas pequenas, o arquivo continua funcionando e não há urgência. O ganho real aparece em catálogos grandes, em marketplaces e em plataformas que gerenciam várias contas, onde o custo de manter dezenas de arquivos sincronizados sempre foi alto.
O que fazer nesta semana
- Confirme se a conta está inscrita no programa de classificações do produto, pela sub-API Programs ou pelo Merchant Center.
- Revise o caminho de menu usado na sua documentação interna, porque a navegação antiga não existe mais.
- Liste de onde vêm suas avaliações hoje e quanto tempo elas levam para chegar ao Google.
- Se o atraso passa de um dia e o catálogo é grande, coloque a migração para a API no backlog do trimestre.
- Antes de automatizar, revise a política de avaliações incentivadas na sua operação.
Quem já trabalha os atributos das fichas com cuidado, como a duração de oferta e a categoria do produto ou os identificadores de dados estruturados, vai reconhecer o padrão: o Google recompensa quem entrega dado completo e atualizado. A avaliação acabou de entrar nessa mesma régua.
Perguntas frequentes
O envio de avaliações pela Merchant API substitui o feed de arquivo?
Não. O arquivo continua sendo um método válido de envio. A API é uma alternativa para quem quer automatizar e reduzir o atraso entre a coleta da avaliação e a exibição no Google.
Qualquer conta do Merchant Center pode usar a API de avaliações?
Não. É preciso ter um feed de avaliações ativo e estar inscrito no programa de classificações do produto. A qualificação pode ser verificada pela sub-API Programs ou pela interface do Merchant Center.
A mudança vale também para avaliações do vendedor?
O Google mantém um guia específico para avaliações do vendedor na Merchant API. São fluxos separados, mas ambos seguem a mesma lógica de envio programático.
Preciso migrar agora?
Se a sua operação é pequena e o feed atual funciona, não há urgência. A migração compensa em catálogos grandes, em plataformas multiconta e em operações onde o atraso do arquivo já causa divergência.
Automatizar o envio reduz o risco de reprovação por política?
Não por si só. A automação acelera o envio, inclusive de avaliações que violam a política de conteúdo incentivado. A revisão da origem das avaliações continua sendo responsabilidade da loja.
