NuevoProduct Score, 4T Segmentation, Price War y Broken Size ya están disponibles.Ver las novedades
Feedance
Artículo

Cómo solucionar los errores 410 de la Content API de Google: migrar su flujo de feeds a la Merchant API

La Content API for Shopping ya devuelve errores 410. Localice las llamadas restantes, asígnelas a la Merchant API y verifique sus productos en Merchant Center.

Cagdas PolatCagdas Polat
10 min de lectura
Cómo solucionar los errores 410 de la Content API de Google: migrar su flujo de feeds a la Merchant API

La Content API for Shopping de Google dejó de estar disponible el 18 de agosto de 2026. Desde el 1 de septiembre, las solicitudes de proyectos sin una prórroga aprobada fallan de forma intermitente con HTTP 410, y los endpoints se cerrarán por completo a principios de 2027 (aviso de retirada de Google). Si un script, un plugin o un conector interno sigue enviando sus productos a Merchant Center a través de la API antigua, algunas de esas actualizaciones ya se están perdiendo.

Esta guía está dirigida a los desarrolladores y responsables de feeds que mantienen ellos mismos ese flujo de datos. Al terminar, podrá localizar todas las llamadas que quedan a la Content API, asignar cada una a su equivalente en la Merchant API, crear la fuente de datos que exige la nueva API y confirmar en Merchant Center que los productos y los precios siguen llegando.

Cómo saber si le afecta la retirada

El fallo es fácil de pasar por alto porque es intermitente. Google documenta el cuerpo del error como un 410 con un mensaje que empieza por "Content API for Shopping was sunset on August 18, 2026", e incluye el ID y el número de su proyecto de Google Cloud y un enlace al centro de ayuda. Busque esa cadena y shoppingcontent.googleapis.com en los registros de su integración.

Normalmente aparecen tres síntomas antes de que nadie lea un registro:

  • Los cambios de precio o de disponibilidad llegan a Google con horas de retraso, o solo en algunas ejecuciones.
  • Una tarea diaria informa de que la mayoría de los lotes se han procesado correctamente y de que unos pocos han fallado.
  • Merchant Center muestra datos obsoletos mientras su tienda muestra el precio correcto.

El último síntoma tiene una segunda causa posible: las actualizaciones automáticas de artículos de Google que sobrescriben sus valores. Lo tratamos por separado en cómo evitar que Google sobrescriba silenciosamente el precio y la disponibilidad de su feed. Descarte primero los errores 410, porque es más fácil confirmarlos.

Paso 1: Haga un inventario de todo lo que llama a la API antigua

La propia recomendación de Google es revisar el código de su aplicación en busca de llamadas directas a los endpoints de la Content API. En la práctica, las llamadas se esconden en cuatro lugares: el plugin de Google de la plataforma de la tienda, un script personalizado que escribió un desarrollador anterior, un middleware de feeds o del ERP, y un script de Google Ads o de Apps Script que alguien programó hace años.

Cree un registro breve con una fila por cada llamante. Anote qué hace, con qué proyecto de Google Cloud se autentica y quién es su responsable. El ID del proyecto es importante porque las prórrogas y el mensaje 410 están vinculados a él.

LlamanteQué envíaResponsableAcción
Plugin de la tiendaCatálogo completo, a diarioProveedor de la plataformaPreguntar qué versión de la API utiliza ahora
Script de inventarioPrecio y stock, cada horaSu desarrolladorMigrar a la Merchant API
Herramienta de gestión de feedsFeed optimizadoProveedor de la herramientaPedir confirmación de la migración por escrito

Si un proveedor gestiona la conexión, su trabajo es preguntar, no reconstruir. Tanto Productsup como Feedonomics han publicado documentación sobre la migración, y un proveedor consolidado ya habrá hecho el cambio. Haga a todos los proveedores de su lista la misma pregunta y guarde las respuestas.

Paso 2: Decida si necesita una prórroga

Google ofrece un formulario de solicitud de prórroga de la Content API para las organizaciones que necesitan más tiempo. Las prórrogas aprobadas protegen un proyecto frente a las respuestas de error programadas durante el periodo aprobado, y no se extienden más allá del desmantelamiento definitivo a principios de 2027. Google no indica quién cumple los requisitos.

Aplique esta regla de decisión. Si todos los llamantes pueden migrarse y probarse en unas pocas semanas, olvídese de la prórroga y dedique ese tiempo a la migración. Si un llamante pertenece a un proveedor con una migración confirmada pero sin fecha, solicite una prórroga solo para ese proyecto. Una prórroga es un margen de seguridad, no un plan.

Paso 3: Asigne cada llamada a su equivalente en la Merchant API

La Merchant API divide el antiguo bloque monolítico en sub-API y versiona la URL (/products/v1/). La versión v1 alcanzó la disponibilidad general en julio de 2025 y la v1beta se retiró el 28 de febrero de 2026, así que desarrolle sobre la v1 e ignore cualquier tutorial de la v1beta que encuentre (notas de la versión de la Merchant API).

Content APIMerchant APIQué cambia
products.insertproductInputs.insertRequiere un parámetro de consulta dataSource
products.updateproductInputs.patchActualización persistente de una entrada de producto
products.deleteproductInputs.deleteRequiere un parámetro dataSource
products.get / listproducts.get / listDevuelve el producto procesado, de solo lectura
productstatuses.get / listproducts.get / listEl estado ahora forma parte del recurso Product
custombatchLlamadas asíncronas en paraleloNo existe ningún método customBatch
datafeedsdataSourcesCada fuente de datos se dirige a una sola etiqueta de feed y un solo idioma

Fuente: la correspondencia para la migración de productos y la correspondencia de fuentes de datos de Google. El cambio conceptual es la división entre un ProductInput, que son los datos en bruto que usted escribe, y un Product, que es el resultado procesado que solo puede leer. Un producto procesado se construye a partir de una entrada principal más las entradas complementarias que haya, después de aplicar las reglas del feed (descripción general de los productos).

Paso 4: Cree la fuente de datos de API antes de insertar nada

Este es el paso que hace fallar la mayoría de las primeras migraciones. La Content API creaba automáticamente una fuente de datos "Content API" en su primera inserción. La Merchant API no lo hace. Google indica que debe crear al menos una fuente de datos de tipo API y que la sub-API Products solo puede escribir en fuentes de datos de ese tipo (migración de fuentes de datos).

Cada fuente de datos corresponde ahora a una única combinación de feedLabel y contentLanguage. Si atendía Turquía en turco y los Emiratos Árabes Unidos en inglés desde un único feed con varios destinos, ahora necesita fuentes de datos separadas. Créelas mediante la sub-API Data Sources o en Merchant Center y, después, utilice el nombre de recurso resultante, con el formato accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}, en cada escritura.

Paso 5: Reescriba la carga útil, con un ejemplo práctico

Tres cambios de campo provocan la mayoría de los errores. El precio pasa de una cadena decimal a micros enteros, donde un millón de micros equivale a una unidad de moneda. Los atributos del producto pasan a un objeto productAttributes. Y targetCountry se sustituye por feedLabel, mientras que channel desaparece.

El identificador de producto antiguo tenía este aspecto, y el nuevo utiliza virgulillas y prescinde del canal:

Content API:  online:en:US:SKU12345
Merchant API: en~US~SKU12345

Una entrada de producto como la que utiliza de ejemplo la propia guía de Google tiene este aspecto (se inserta con POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}):

{
  "offerId": "SKU12345",
  "contentLanguage": "en",
  "feedLabel": "US",
  "productAttributes": {
    "title": "Classic Cotton T-Shirt",
    "link": "https://www.example.com/p/SKU12345",
    "imageLink": "https://www.example.com/img/SKU12345.jpg",
    "availability": "IN_STOCK",
    "price": { "amountMicros": "15990000", "currencyCode": "USD" },
    "condition": "NEW",
    "gtins": ["9780007350896"]
  }
}

Compárelo con la estructura antigua: "price": {"value": "15.99", "currency": "USD"} pasa a ser amountMicros y currencyCode, y la disponibilidad pasa a ser un enum, de modo que in stock se convierte en IN_STOCK. Fuente: guía de Google para añadir y gestionar productos.

En liras turcas, 1.249,90 TRY es "amountMicros": "1249900000". Calcule los micros con aritmética de enteros sobre la unidad menor, no multiplicando un número de coma flotante, o enviará 1249899999 y se preguntará por qué los precios difieren por un pelo.

Utilice también el nuevo campo versionNumber cuando varias tareas escriban el mismo producto. Evita que una actualización más antigua sobrescriba otra más reciente cuando las solicitudes llegan desordenadas.

Paso 6: Sustituya el procesamiento por lotes y lea el estado desde el producto

No existe customBatch. Sustitúyalo por solicitudes asíncronas en paralelo con un límite de concurrencia y vuelva a intentar solo las que fallen. Mantenga un registro de resultados por oferta para que un fallo parcial no se convierta silenciosamente en un catálogo obsoleto.

Para el estado, deje de llamar a productstatuses. Lea en su lugar el Product procesado, que incluye su estado. Google advierte que puede haber un retraso de unos minutos entre una inserción o actualización y el momento en que el producto final está disponible, así que una lectura inmediatamente después de una escritura no sirve para comprobar si ha fallado.

Paso 7: Verifique antes de desactivar la vía antigua

Ejecute primero la nueva vía con una parte pequeña y de bajo riesgo del catálogo, por ejemplo 50 productos de una etiqueta de feed. A continuación, evalúe el cambio con esta lista de comprobación. Todas las líneas deben ser un sí antes de retirar el llamante antiguo.

  • El llamante se autentica en el proyecto que registró y no devuelve ningún 410 durante siete días consecutivos.
  • Existe una fuente de datos de API para cada par de etiqueta de feed e idioma que atiende.
  • En la parte de prueba, el producto procesado coincide con su fuente de referencia en precio, disponibilidad y enlace.
  • Nada más sigue escribiendo los mismos ID de oferta desde la fuente de datos antigua.
  • Las ofertas fallidas se registran con un reintento, no se descartan.
  • Todos los llamantes gestionados por proveedores de su registro tienen una confirmación de migración por escrito.

El cuarto punto merece atención. Un segundo escritor para el mismo ID de oferta, por ejemplo el llamante antiguo y una nueva fuente de datos de API, es la forma de acabar con valores contradictorios. Decida qué fuente es responsable de cada producto y elimine la otra.

Dónde se queda corta esta guía

Hemos escrito esta guía a partir de la documentación publicada por Google y no hemos migrado su código. Hay varias cosas que quedan fuera de ella. Google no indica los requisitos para obtener una prórroga, así que no podemos decirle si un proyecto concreto será aprobado. La descripción general de los productos no documenta los tiempos más allá de "unos minutos", así que cualquier expectativa de latencia más estricta tendrá que medirla usted. El inventario local, el inventario regional, las promociones y las reseñas tienen cada uno sus propios subrecursos en la Merchant API, y no hemos tratado aquí sus correspondencias.

Si no quiere hacerse cargo de una integración de API, una plataforma de feeds gestionada es mejor respuesta que una reescritura. Tanto Productsup como Feedonomics publican orientaciones sobre la migración a la Merchant API, y para un equipo empresarial con modelos de datos poco habituales cualquiera de ellas puede encajar mejor que nuestra solución. Para Google Shopping en concreto, nuestra propia solución se describe en la página de integración con Google Merchant Center.

Preguntas frecuentes

¿Sigue funcionando la Content API for Shopping?

No de forma fiable. Google indica que se retiró el 18 de agosto de 2026, que las solicitudes sin una prórroga activa empezaron a fallar de forma intermitente con HTTP 410 a partir del 1 de septiembre de 2026 y que todos los endpoints se cerrarán a principios de 2027.

¿Qué dice el error 410 de la Content API?

El mensaje empieza por "Content API for Shopping was sunset on August 18, 2026". La respuesta incluye el ID y el número de su proyecto de GCP y un enlace al centro de ayuda, lo que le indica qué proyecto debe migrar o prorrogar.

¿Puedo conseguir más tiempo con una prórroga?

Google ofrece un formulario de solicitud de prórroga de la Content API. Las prórrogas aprobadas protegen su proyecto frente a los errores programados solo durante el periodo aprobado, y no van más allá del desmantelamiento de principios de 2027.

¿Por qué productInputs.insert pide un dataSource?

Las escrituras de la Merchant API pertenecen a una fuente de datos explícita. A diferencia de la API antigua, no crea una fuente de datos "Content API" en su primera inserción, así que debe crear una fuente de datos de tipo API y pasar su nombre de recurso.

¿Cómo envío los precios en la Merchant API?

Utilice amountMicros como cadena de número entero y currencyCode en formato ISO 4217. Un millón de micros equivale a una unidad de moneda, así que 15,99 USD son 15990000.

¿Admite la Merchant API el procesamiento por lotes?

No existe ningún método customBatch. La recomendación de Google es utilizar llamadas asíncronas en paralelo, lo que significa que debe añadir su propio límite de concurrencia y reintentos por oferta.

¿Dónde ha ido a parar productstatuses?

Ahora el estado forma parte del recurso Product procesado. Utilice products.get o products.list para leerlo, teniendo en cuenta que el procesamiento puede ir unos minutos por detrás de una inserción.

¿Sobre qué versión de la Merchant API debo desarrollar?

Desarrolle sobre la v1, que alcanzó la disponibilidad general en julio de 2025. La versión v1beta se retiró el 28 de febrero de 2026, así que los tutoriales escritos para ella fallarán.

Compruebe lo que Google ve realmente

Después de la migración, la comprobación más rápida es comparar su feed de origen con lo que ha procesado Merchant Center. Analice su feed activo con nuestra herramienta gratuita de auditoría de feeds de productos para obtener una puntuación de completitud y calidad, y corrija lo que señale antes del siguiente ciclo de anuncios.

¿Quiere que alguien más revise su feed? Lo revisaremos con usted y le mostraremos dónde están las carencias antes de su próximo envío.
Solicitar una auditoría gratuita
Cagdas Polat
Escrito por
Cagdas Polat

Cofundador de Feedance, donde aprovecha su formación como ingeniero informático y profesional del marketing para impulsar análisis basados en datos. Con un fuerte enfoque en convertir los datos en estrategias accionables, se dedica a ayudar a las marcas a lograr un crecimiento significativo en el entorno digital.

LinkedIn

Descubra qué
productos generan ingresos.

Conecte su feed y GA4. Mostramos Product Score, 4T, Price War y Broken Size en su propio catálogo.