Problemas conocidos

En esta página, se documentan las inquietudes conocidas de los desarrolladores con la API de Merchant.

UnauthenticatedException errores aleatorios

Fecha del informe: 2026-03-30 (UTC) | Última actualización: 2026-04-17 (UTC)

Varios clientes experimentan errores UnauthenticatedException intermitentes cuando suben productos y acceden a otras APIs de Merchant Center. Los errores se producen de forma aleatoria, incluso con reintentos, y afectan tanto a las llamadas iniciales como a los intentos posteriores. Algunas conexiones fallan, mientras que otras se realizan correctamente en poco tiempo.

Se implementó una mitigación y se sigue investigando una solución permanente. Si encuentras este error, te recomendamos que vuelvas a intentar las llamadas a la API.

Latencia elevada, mensajes de DEADLINE_EXCEEDED y INTERNAL_ERROR para los métodos de productos y de inventarios

Se informó el 18 de marzo de 2026 (UTC) | Se resolvió el 31 de marzo de 2026 (UTC)

Algunos usuarios experimentaron latencia sostenida y mensajes frecuentes de DEADLINE_EXCEEDED o INTERNAL_ERROR cuando usaban los métodos productInputs y regionalInventories. Se identificó que la causa principal fue un incidente a nivel del backend que afectó la eficiencia del procesamiento.

Resolución: Este incidente se mitigó por completo el 31 de marzo de 2026. Después de la mitigación, los porcentajes de errores disminuyeron significativamente. Si sigues experimentando una latencia alta, te recomendamos que verifiques los tiempos de espera del cliente y reduzcas los tamaños de los lotes de solicitudes.

Problemas de capacidad de procesamiento para los métodos de productos y de inventarios insert

Fecha del informe: 28 de enero de 2026 (UTC) | Última actualización: 31 de marzo de 2026 (UTC)

Recibimos informes sobre problemas de rendimiento del cliente con la capacidad de procesamiento mientras se transmitían grandes cantidades de datos a la API de Merchant. Es posible que veas este problema cuando uses bibliotecas cliente para los siguientes métodos:

• accounts.productInputs.insert
• accounts.products.localInventories.insert
• accounts.products.regionalInventories.insert

Realizamos mejoras para aumentar el rendimiento de varios sistemas de backend. Si el problema persiste, es posible que debas configurar un grupo de canales para maximizar la capacidad de procesamiento. Esto evita el límite típico de 100 transmisiones de un solo canal de gRPC, ya que administra varias conexiones subyacentes. Para obtener más información, consulta Refactoriza el código para solicitudes simultáneas: Mejora la capacidad de procesamiento con grupos de canales.

Identificadores de productos con caracteres especiales

Fecha del informe: 2025-10-03 (UTC) | Última actualización: 2026-04-08 (UTC)

Es posible que los usuarios tengan problemas cuando administren productos en los que productId o offerId no respeten los lineamientos de formato del ID del producto. Estos IDs de productos pueden contener caracteres especiales, en particular, barras diagonales (/), dos puntos (:), virgulillas (~) y signos de porcentaje (%). Las plataformas como Merchant Center ya permiten algunos caracteres especiales en los IDs de productos.

Dado que la API de Merchant incorpora el identificador del producto directamente en el recurso name como parte de la URL (por ejemplo, accounts/{account}/products/{productId}), estos caracteres pueden interferir en el enrutamiento y el análisis de URLs estándar, lo que genera errores inesperados de 404 Not Found o 400 Bad Request durante las operaciones GET, PATCH o DELETE.

Para interactuar de forma segura con los productos que contienen estos caracteres, debes codificar el segmento productId o offerId del nombre del recurso. El algoritmo de codificación es Base64URL sin relleno. Para obtener más información, consulta accounts.productInputs.name.

Resuelto: Lanzamos una solución para estandarizar el comportamiento en todo el ecosistema de la API de Merchant. Agregamos un nuevo campo base64_encoded_name a las respuestas de la API que proporciona el nombre del recurso codificado previamente, lo que te permite usar el resultado de una llamada de lista o de obtención directamente como entrada para las actualizaciones posteriores sin realizar la codificación manual.

Demora después de la creación de la fuente de datos

Fecha del informe: 2024-04-10 (UTC) | Última actualización: 2024-05-12 (UTC)

Se produjo una demora conocida cuando se intentó insertar productos, promociones o opiniones inmediatamente después de crear un objeto DataSource nuevo. Se devolvió el error Data source not found cuando se intentaron insertar elementos dentro de los 5 minutos posteriores a la creación de la fuente de datos.

Solucionado: Se eliminó esta demora, lo que permite una interacción más inmediata con las fuentes de datos recién creadas.

¿Tienes algún otro problema?

Visita nuestras páginas Obtén ayuda con la API de Merchant y Envía comentarios para cualquier otro problema.