Problemas conocidos

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

Errores aleatorios UnauthenticatedException

Informado: 30 de marzo de 2026 (UTC)

Varios clientes experimentan errores intermitentes UnauthenticatedException 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.

Hasta el momento, no hay soluciones alternativas ni recomendaciones.

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

Informado: 18 de marzo de 2026 (UTC) | Resuelto: 31 de marzo de 2026 (UTC)

Algunos usuarios experimentaron latencia sostenida y mensajes frecuentes 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 lote de las solicitudes.

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

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

Recibimos informes de problemas de rendimiento del cliente con el 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:

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

Identificadores de productos con caracteres especiales

Informado: 3 de octubre de 2025 (UTC) | Última actualización: 8 de abril de 2026 (UTC)

Es posible que los usuarios tengan problemas cuando administran productos en los que productId o offerId no respetan los lineamientos de formato del ID de producto. Es posible que estos IDs de producto contengan 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 producto.

Como la API de Merchant incorpora el identificador de producto directamente en el name del recurso como parte de la URL (por ejemplo, accounts/{account}/products/{productId}), estos caracteres pueden interferir con el enrutamiento y el análisis de URL estándar, lo que genera errores inesperados 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 la codificación Base64URL sin relleno. Para obtener más información, consulta accounts.productInputs.name.

Resuelto: Implementamos 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 lista o llamar directamente como entrada para actualizaciones posteriores sin realizar la codificación manual.

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

Informado: 10 de abril de 2024 (UTC) | Última actualización: 12 de mayo de 2024 (UTC)

Se produjo una demora conocida cuando se intentó insertar productos, promociones o reseñas inmediatamente después de crear un DataSource nuevo. Se mostró 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.

Resuelto: 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?

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