Esta página documenta as preocupações conhecidas dos desenvolvedores com a API Merchant.
Problemas de capacidade de processamento para métodos insert de produtos e inventários
Relatado em: 28/01/2026 UTC | Última atualização: 31/03/2026 UTC
Recebemos relatórios de problemas de desempenho do lado do cliente com a capacidade de processamento ao transmitir grandes quantidades de dados para a API Merchant. Esse problema pode ocorrer ao usar bibliotecas de cliente para os seguintes métodos:
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
Fizemos melhorias para aumentar o desempenho de vários sistemas de back-end. Se o problema persistir, talvez seja necessário configurar um pool de canais para maximizar a capacidade de processamento. Isso ignora o limite típico de 100 streams de um único canal gRPC, gerenciando várias conexões subjacentes. Para mais informações, consulte Refatorar o código para solicitações simultâneas: melhorar a capacidade de processamento com pools de canais.
Identificadores de produto com caracteres especiais
Relatado em: 03/10/2025 UTC | Última atualização: 08/04/2026 UTC
Os usuários podem encontrar problemas ao gerenciar produtos em que o productId ou o offerId não respeitam as diretrizes de formatação do ID do produto.
Esses IDs de produto podem conter caracteres especiais, principalmente barras (/), dois-pontos (:), tils (~) e sinais de porcentagem (%). Plataformas
como o Merchant Center já permitem alguns caracteres especiais em IDs de produto.
Como a API Merchant incorpora o identificador de produto diretamente no
recurso name como parte do URL (por exemplo,
accounts/{account}/products/{productId}), esses caracteres podem interferir no
roteamento e na análise padrão de URLs, levando a erros inesperados de 404 Not Found ou
400 Bad Request durante as operações GET, PATCH ou DELETE.
Para interagir com segurança com produtos que contêm esses caracteres, é necessário
codificar o segmento productId ou offerId do nome do recurso. O algoritmo de codificação é codificação Base64URL sem preenchimento. Para ver mais informações, consulte
accounts.productInputs.name.
Resolvido: lançamos uma solução para padronizar o comportamento em todo o ecossistema da API Merchant. Adicionamos um novo campo base64_encoded_name às respostas da API
que fornece o nome do recurso pré-codificado, o que permite usar a
saída de uma lista ou receber uma chamada diretamente como entrada para atualizações subsequentes
sem realizar a codificação manual.
Atraso após a criação da fonte de dados
Relatado em: 10/04/2024 UTC | Última atualização: 12/05/2024 UTC
Ocorreu um atraso conhecido ao tentar inserir produtos, promoções ou avaliações
imediatamente após a criação de um novo DataSource. O erro Data source not found
foi retornado ao tentar inserir itens em até cinco minutos após a criação da fonte de
dados.
Resolvido: esse atraso foi eliminado, permitindo uma interação mais imediata com as fontes de dados recém-criadas.
Algum outro problema?
Acesse as páginas Receber ajuda com a API Merchant e Enviar feedback para resolver outros problemas.