Problemas conhecidos

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

UnauthenticatedException erros aleatórios

Informado em:30/03/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.

Por enquanto, não há uma solução alternativa ou recomendações.

Latência elevada, DEADLINE_EXCEEDED e mensagens INTERNAL_ERROR para métodos de produtos e inventários

Informado:18/03/2026 UTC | Resolvido:31/03/2026 UTC

Alguns usuários tiveram latência sustentada e mensagens frequentes de DEADLINE_EXCEEDED ou INTERNAL_ERROR ao usar os métodos productInputs e regionalInventories. A principal causa foi identificada como um incidente no nível do back-end que afetou a eficiência do processamento.

Resolução:esse incidente foi totalmente resolvido em 31 de março de 2026. Após a mitigação, as taxas de erro diminuíram significativamente. Se a latência continuar alta, recomendamos verificar os tempos limite do lado do cliente e reduzir os tamanhos dos lotes de solicitações.

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 a 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:

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 fluxos 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 productId ou offerId não respeitam as diretrizes de formatação de ID do produto. Esses IDs podem conter caracteres especiais, principalmente barras (/), dois pontos (:), til (~) e porcentagens (%). 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:implementamos 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.