La siguiente es una lista de errores en orden alfabético.
auth/account_access_denied
User cannot access account
<account_number>
Resumen
Emitiste una solicitud segmentada para una cuenta a la que el usuario autenticado no tiene acceso.
Causas habituales
Error en el ID del comercio de destino o se olvidó registrar al usuario en Merchant Center.
Sugerencias de manejo recomendadas
Verifica que te orientes a la cuenta correcta o regístrate como usuario de la cuenta en Merchant Center (Configuración > Usuarios).
Sugerencias de prevención
NA
User is not an administrator of
account <account_number>
Resumen
Emitiste una solicitud para modificar una cuenta para la que el usuario autenticado no tiene derechos de administrador.
Causas habituales
NA
Sugerencias de manejo recomendadas
Establece los derechos de administrador para el usuario autenticado.
Sugerencias de prevención
NA
conflicto
[productId] Product ID <product
id> is already modified by another entry in the same request for merchant
<merchant> and store code <store code>
Resumen
Se intentaron varias operaciones en conflicto al mismo tiempo.
Causas habituales
Una sola solicitud de lote contiene varias operaciones en conflicto para el mismo producto o se enviaron varias operaciones en conflicto para el mismo producto a la API de Content al mismo tiempo.
Sugerencias de manejo recomendadas
Consulta las sugerencias de prevención.
Sugerencias de prevención
Contiene todos los cambios de un producto determinado en una sola operación en un conjunto de solicitudes por lotes. Evita realizar varias llamadas simultáneas a Content API para el mismo comercio y código de tienda, o asegúrate de que esas llamadas no contengan productos superpuestos.
Se proporcionó un canal no válido como parte de un ID de producto.
Por ejemplo: not_a_channel:en:US:sku123.
Causas habituales
NA
Sugerencias de manejo recomendadas
NA
Sugerencias de prevención
Asegúrate de que el ID de tu producto tenga el formato channel:languageCode:countryCode:offerId, por ejemplo: online:en:US:sku123. Para obtener más información, consulta la documentación de referencia de Products.insert.
[countrycode] Invalid country code:
'<country_code>'
Resumen
Se proporcionó un código de país no válido como parte de un ID de producto.
Por ejemplo: online:en:not_a_country_code:sku123.
Causas habituales
NA
Sugerencias de manejo recomendadas
NA
Sugerencias de prevención
Asegúrate de que el ID de tu producto tenga el formato channel:languageCode:countryCode:offerId y de que el código de país sea un código de país
ISO 3166 válido.
[item id] Invalid item
id: '<id>'
Resumen
ID de artículo no válido, p.ej., sku123 en lugar de online:en:US:sku123.
Causas habituales
Especificar un ID de oferta en lugar de un ID de producto en una solicitud GET o DELETE
Sugerencias de manejo recomendadas
NA
Sugerencias de prevención
Asegúrate de que el ID de tu producto tenga el formato channel:languageCode:countryCode:offerId.
Intentaste actualizar el precio y la disponibilidad de un producto en línea a través del feed de inventario, pero especificaste algo diferente del valor especial online como el ID de tienda en la URL.
Causas habituales
NA
Sugerencias de manejo recomendadas
Cambia el ID de tienda a online en la URL de la solicitud.
Sugerencias de prevención
Asegúrate de especificar online para los productos en línea y el ID de tienda para los productos locales en todas tus consultas de inventario.
[<attribute>]
Resumen
El elemento especificado entre corchetes no es válido.
El elemento que intentaste obtener, actualizar o borrar no existe.
Causas habituales
Intentar borrar un producto que no existe o no especificar el ID del producto correctamente en la URL para borrarlo
Sugerencias de manejo recomendadas
Obtén una lista de productos con Products.list y solo intenta obtener, actualizar o borrar los elementos que aparecen allí. Asegúrate de especificar el ID del producto en el formato channel:languageCode:countryCode:offerId, por ejemplo: online:ru:RU:277104-ekb, en lugar del ID de la oferta, que se ve de la siguiente manera: 277104-ekb.
Sugerencias de prevención
NA
not_inserted
The item could not be
inserted.
Resumen
Debido a otros errores, no se pudo insertar el producto, ya que se reemplazaría una entrada válida existente.
Causas habituales
NA
Sugerencias de manejo recomendadas
Verifica los otros errores de la misma llamada y solucionándolos antes de intentar volver a insertar la información del producto nuevo.
Sugerencias de prevención
NA
cuota
too_many_items: Merchant
quota exceeded
Resumen
Se subieron demasiados artículos a Google Shopping.
Causas habituales
Los productos que no se validen se pueden insertar si no reemplazan un producto válido existente. Considera usar la marca includeInvalidInsertedItems en Productstatuses.list para asegurarte de que tu cuenta no tenga una cantidad excesiva de productos no válidos.
Sugerencias de manejo recomendadas
Busca y quita la cantidad excesiva de productos no válidos, como se mencionó anteriormente. Además, especifica las
fechas de vencimiento cuando subas productos. Cuando se alcanza la fecha de vencimiento, el producto se borra automáticamente. Ten en cuenta que la fecha de vencimiento predeterminada y máxima es de 30 días después de la inserción o actualización del producto.
Nota: La cuota de artículos de una cuenta de varios clientes se verifica en función de la cantidad total de productos en todas las cuentas secundarias. Si recibes este error con una cuenta secundaria, asegúrate de que la cuenta secundaria y tu MCA tengan suficiente cuota de productos.
request_rate_too_high:
Request rate too high. Please reduce your throughput
Resumen
Se están realizando solicitudes demasiado rápido. Reduce la frecuencia de las solicitudes.
Causas habituales
Consulta las cuotas por minuto que se indican en los
límites publicados. Si superas estos umbrales, recibirás este error. A veces, hay un aumento repentino del tráfico que causa esto, o tu servidor se expande a una cantidad mayor de subprocesos.
Sugerencias de manejo recomendadas
Reduce la cantidad total de solicitudes enviadas por minuto.
Sugerencias de prevención
Cuando recibas este error, usa estrategias de tiempo de espera programático para reducir la tasa de solicitudes a un nivel sostenible adecuado.
daily_limit_exceeded:
merchant quota exceeded
Resumen
Estás realizando más solicitudes por día que la cantidad permitida para el método de servicio determinado.
Causas habituales
Consulta las cuotas por día que se indican en los límites publicados. Si superas estos umbrales, recibirás este error.
Sugerencias de manejo recomendadas
Combina varios cambios en una sola solicitud cuando sea posible para reducir la cantidad total de solicitudes que se envían por día. Considera realizar cambios por lotes en los productos durante un período adecuado para evitar cambiar un producto varias veces rápidamente. En el caso de las actualizaciones de artículos que se pueden representar como microdatos en tu sitio web, considera usar ese enfoque para limitar la cantidad de llamadas a los servicios de Products o Inventory.
Si aún necesitas más llamadas diarias a un método determinado, comunícate con nosotros y danos tu ID de Merchant Center, los métodos en los que alcanzas los límites de cuota, una estimación de cuántas llamadas por día necesitarás para esos métodos y por qué. Trabajaremos contigo para aumentar tu cuota.
Sugerencias de prevención
Consulta las sugerencias de manejo recomendadas.
too_many_failed_auths:
Too many failed authentications.
Resumen
Realizas demasiadas solicitudes por lotes para cuentas a las que no tienes acceso.
Causas habituales
Realizar solicitudes por lotes para cuentas secundarias que se borraron o para cuentas secundarias recién creadas antes de que estén disponibles
Sugerencias de manejo recomendadas
Evita realizar llamadas que afecten a una cuenta secundaria borrada.
Sugerencias de prevención
Consulta las sugerencias de manejo recomendadas.
request_too_large
Resumen
Estás enviando demasiados entries por solicitud por lotes o superas el límite de tamaño de la solicitud de custombatch.
Causas habituales
Puedes incluir un máximo de 10,000 entries por solicitud custombatch, y el límite de tamaño de transferencia comprimido es de 32 MB.
Sugerencias de manejo recomendadas
Divide el lote en varios lotes que estén por debajo de los límites y, luego, vuelve a intentarlo.
Sugerencias de prevención
Te recomendamos que no envíes más de
1,000 entradas por lote.
obligatorio
[price.value] Required parameter: price.value
Resumen
Se especificó un precio sin valor. Por ejemplo, { "currency": "USD" } en lugar de { "value": 123, "currency": "USD" }.
Causas habituales
NA
Sugerencias de manejo recomendadas
Asegúrate de que el parámetro, aquí price, tenga el formato correcto. Por ejemplo, price tiene dos campos obligatorios: value y currency.
Sugerencias de prevención
NA
[product] INSERT request must specify
product
Resumen
Se envió una solicitud por lotes personalizada a la API que contiene una entrada con "method": "insert", pero no hay ningún producto.
Causas habituales
Olvidar cambiar el método a get o delete
Sugerencias de manejo recomendadas
Especifica un producto para insertarlo a través del campo product.
Sugerencias de prevención
Asegúrate de que las entradas por lotes con el método insert especifiquen un producto, y que las entradas por lotes con el método get o delete especifiquen un ID de producto.
[productId] DELETE request must specify
productId
Resumen
Se envió una solicitud por lotes personalizada a la API que contiene una entrada con "method": "delete", pero sin un ID de producto.
Causas habituales
Olvidar cambiar el método a insert
Sugerencias de manejo recomendadas
Especifica un producto para borrar a través del campo productID.
Sugerencias de prevención
Asegúrate de que las entradas por lotes con el método insert especifiquen un producto, y que las entradas por lotes con el método get o delete especifiquen un ID de producto.
userRateLimitExceeded
User Rate Limit
Exceeded
Resumen
Se están realizando solicitudes demasiado rápido. Reduce la frecuencia de las solicitudes.
Causas habituales
Consulta los límites de solicitudes HTTP que se indican en los límites publicados. Si superas estos umbrales, recibirás este error. A veces, hay un aumento repentino del tráfico que causa esto, o tu servidor se expande a una mayor cantidad de subprocesos.
Sugerencias de manejo recomendadas
Reduce la cantidad total de solicitudes enviadas por minuto. Agrupar varias llamadas de método al mismo servicio en una sola solicitud custombatch reducirá la cantidad de solicitudes HTTP que se realizan.
Sugerencias de prevención
Cuando recibas este error, usa el procesamiento por lotes y las estrategias de retirada programática para reducir la frecuencia de solicitudes a un nivel sostenible adecuado.
validación
[adwords_redirect]
Resumen
Enviaste un producto cuyo campo adwords_redirect no es una URL válida.
Causas habituales
NA
Sugerencias de manejo recomendadas
Asegúrate de que el valor del campo
adwords_redirect sea una URL válida.
Sugerencias de prevención
NA
[item] auth/frontend/not_claimed
Resumen
No se reclamó la URL del sitio web del comercio en Merchant Center.
Enviaste una marca, una descripción o algún otro atributo como una cadena que no se analiza con la codificación de solicitud especificada.
Causas habituales
NA
Sugerencias de manejo recomendadas
Revisa el mensaje para averiguar qué atributo está causando el problema y, luego, valida la codificación de texto del valor correspondiente antes de volver a enviarlo. La API solo acepta caracteres UTF-8 válidos.
Sugerencias de prevención
NA
[<attribute>] invalid_value
Resumen
Enviaste un color, una descripción o algún otro atributo que no es válido.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-06-19 (UTC)"],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],["The document details errors within the Merchant API, which is the future version of the Content API for Shopping. Key errors involve `notFound` (item does not exist), `not_inserted` (cannot insert due to conflicts), and `quota/too_many_items` (exceeded upload limits). Handling involves verifying product IDs, addressing conflicting entries, and managing quotas. Common causes include incorrect IDs, simultaneous conflicting operations, and exceeding item limits. Prevention focuses on formatting product IDs correctly, batching changes, reducing invalid products, and using product expiration dates. Other errors such as account access, internal issues, URL, currency, ID, and missing parameters are covered.\n"]]
