Esta página documenta problemas conhecidos de desenvolvedores com a API Merchant.
Erros aleatórios UnauthenticatedException
Informado em:30/03/2026 UTC | Última atualização:17/04/2026 UTC
Vários clientes estão enfrentando erros intermitentes UnauthenticatedException ao fazer upload de produtos e acessar outras APIs do Merchant Center.
Os erros ocorrem aleatoriamente, mesmo com novas tentativas, e afetam as chamadas iniciais e as tentativas subsequentes. Algumas conexões falham, enquanto outras são bem-sucedidas em um curto período.
Uma mitigação foi implantada, e a investigação de uma solução permanente está em andamento. Se você encontrar esse erro, recomendamos tentar as chamadas de API novamente.
Latência elevada, mensagens DEADLINE_EXCEEDED e INTERNAL_ERROR para métodos de produtos e inventários
Informado em:18/03/2026 UTC | Última atualização:13/05/2026 UTC
Alguns usuários tiveram latência sustentada e mensagens frequentes DEADLINE_EXCEEDED ou INTERNAL_ERROR ao usar os métodos productInputs e regionalInventories. A principal causa foi identificada como um incidente de back-end que afetou a eficiência do processamento. Os esforços para resolver esse problema ainda estão em andamento.
Se a latência continuar alta, recomendamos reduzir os tamanhos dos lotes de solicitações. Se você estiver recebendo as mensagens de erro mencionadas, tente aumentar os tempos limite do lado do cliente.
Problemas de capacidade de processamento para métodos insert de produtos e inventários
Informado 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 fluxos 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 produtos com caracteres especiais
Informado 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
offerId não respeita as
diretrizes de formatação de ID do produto.
Esses IDs de produtos 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 produtos.
Como a API Merchant incorpora o identificador de produto diretamente no name do recurso como parte do URL (por exemplo, accounts/{account}/products/{productId}), esses caracteres podem interferir no roteamento e na análise de URL padrão, levando a erros inesperados 404 Not Found ou 400 Bad Request durante 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 preenchimento. Para 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 a chamada diretamente como entrada para atualizações subsequentes sem realizar a codificação manual.
Atraso após a criação da fonte de dados
Informado 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 uma nova DataSource. O erro Data source not found foi retornado ao tentar inserir itens em até 5 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.