Esta página documenta problemas conhecidos dos desenvolvedores com a API Merchant.
Problemas de capacidade de processamento para métodos insert de produtos e inventários
Denunciado:28/01/2026 UTC | Última atualização:31/03/2026 UTC
Recebemos relatórios de problemas de desempenho do lado do cliente com taxa de transferência ao transmitir grandes quantidades de dados para a API Merchant. Esse problema pode aparecer ao usar bibliotecas de cliente para os seguintes métodos:
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
Fizemos melhorias para aumentar a performance 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 código para solicitações simultâneas: melhorar a capacidade de processamento com pools de canais.
Identificadores de produto com caracteres especiais
Denunciado em:03/10/2025 UTC | Última atualização:08/04/2026 UTC
Os usuários podem encontrar problemas ao gerenciar produtos em que os atributos productId ou offerId não respeitam as diretrizes de formatação de ID do produto.
Esses IDs podem conter caracteres especiais, principalmente barras
inclinadas (/), dois pontos (:), til (~) e sinais de porcentagem (%). Plataformas
como o Merchant Center já permitem alguns caracteres especiais em IDs de produtos.
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 de URL padrão, resultando em erros inesperados 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 é Base64URL sem padding. 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, permitindo usar a saída de uma lista ou chamar diretamente como entrada para atualizações subsequentes sem realizar a codificação manual.
Atraso após a criação da fonte de dados
Denunciado 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 criar 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 outros problemas.