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 | Resolvido em:31/03/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.
Resolução:esse incidente foi totalmente mitigado em 31 de março de 2026. Após a mitigação, as taxas de erro diminuíram significativamente. Se você continuar enfrentando alta latência, recomendamos verificar os tempos limite do lado do cliente e reduzir os tamanhos dos lotes de solicitação.
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 performance 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 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 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 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 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.