Problemas conhecidos

Esta página documenta problemas conhecidos de desenvolvedores com a API Merchant.

Respostas INTERNAL_ERROR intermitentes

Informado em:29/06/2026 UTC

Estamos recebendo relatórios de respostas INTERNAL_ERROR intermitentes que afetam vários métodos de API. A taxa de erros normalmente é de cerca de 0,1%, mas às vezes pode ser um pouco maior.

Estamos trabalhando ativamente para resolver esse problema. Enquanto isso, se você encontrar esses erros, recomendamos tentar a solicitação novamente. Se você notar taxas de erro altas, entre em contato com o suporte.

Erros aleatórios UnauthenticatedException

Informado em:30/03/2026 UTC | Última atualização:17/04/2026 UTC

Vários clientes estão enfrentando erros UnauthenticatedException intermitentes 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, DEADLINE_EXCEEDED e mensagens 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 DEADLINE_EXCEEDED ou INTERNAL_ERROR frequentes 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ção. 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 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:

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 é a 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.

Anterior
Versioning
Avançar
Overview