A continuación, se incluye una lista de errores en orden alfabético.
auth/account_access_denied
User cannot access account
<account_number>
Resumen
Se emitió una solicitud dirigida a una cuenta a la que el usuario autenticado no tiene acceso.
Causas habituales
Se produjo un error en el ID del comercio objetivo o se olvidó registrar al usuario en Merchant Center.
Sugerencias de manipulación recomendadas
Verifica que segmentes tus anuncios para 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
Se emitió una solicitud para modificar una cuenta para la que el usuario autenticado no tiene derechos de administrador.
Causas habituales
NA
Sugerencias de manipulación recomendadas
Establece 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 conflictivas al mismo tiempo.
Causas habituales
Una sola solicitud por lotes contiene varias
operaciones en conflicto para el mismo producto, o bien se enviaron varias operaciones en conflicto
al mismo producto a la API de Content al mismo
tiempo.
Sugerencias de manipulación recomendadas
Consulta las sugerencias de prevención.
Sugerencias de prevención
Contener todos los cambios de un producto determinado en una sola operación en un conjunto de solicitudes por lotes Intenta evitar varias llamadas simultáneas a la API de Content 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 manipulación recomendadas
NA
Sugerencias de prevención
Asegúrate de que el ID del 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 manipulación recomendadas
NA
Sugerencias de prevención
Asegúrate de que el ID del 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 elemento 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 manipulación recomendadas
NA
Sugerencias de prevención
Asegúrate de que el ID del producto tenga el formato channel:languageCode:countryCode:offerId.
Se intentó actualizar el precio y la disponibilidad de un producto en línea a través del feed de inventario, pero se especificó un valor diferente del valor especial online como ID de la tienda en la URL.
Causas habituales
NA
Sugerencias de manipulación recomendadas
Cambia el ID de la 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 la 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
Se intentó borrar un producto que no existe o no se especificó correctamente el ID del producto en la URL para borrarlo.
Sugerencias de manipulación 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
así: 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 habría sobrescrito una entrada existente.
Causas habituales
NA
Sugerencias de manipulación recomendadas
Verifica los otros errores de la misma llamada y corrígelos 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
Es posible que se inserten los productos que no se validen, si no reemplazan a un producto válido existente. Considera usar la marca includeInvalidInsertedItems para Productstatuses.list y asegurarte de que tu cuenta no tenga una cantidad excesiva de productos no válidos.
Sugerencias de manipulación recomendadas
Verifica y quita la cantidad excesiva de productos no válidos, como se mencionó anteriormente. Además, especifica
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 tanto la cuenta secundaria como tu cuenta de 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, se produce un aumento repentino en el tráfico que causa este problema, o tu servidor se expande a una mayor cantidad de subprocesos.
Sugerencias de manipulación recomendadas
Reduce la cantidad total de solicitudes
enviadas por minuto.
Sugerencias de prevención
Cuando recibas este error, usa estrategias de retirada programática para reducir la tasa de solicitudes a un nivel adecuado y sostenible.
daily_limit_exceeded:
merchant quota exceeded
Resumen
Estás realizando más solicitudes por día de las permitidas 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 manipulación recomendadas
Reduce la cantidad total de solicitudes enviadas por día combinando varios cambios en una sola solicitud cuando sea posible. Considera agrupar los cambios en los productos durante un período adecuado para evitar cambiar un producto varias veces rápidamente. Para las actualizaciones de elementos que se pueden representar como microdatos en tu sitio web, considera usar ese enfoque para limitar la cantidad de llamadas a los servicios Products o Inventory.
Si aún necesitas más llamadas diarias a un método determinado, comunícate con nosotros y háznos saber tu ID de Merchant Center, los métodos en los que estás alcanzando los límites de cuota, una estimación de cuántas llamadas por día necesitarás para esos métodos y el motivo. Trabajaremos contigo para aumentar tu cuota.
Sugerencias de prevención
Consulta las sugerencias de manipulación recomendadas.
too_many_failed_auths:
Too many failed authentications.
Resumen
Estás realizando demasiadas solicitudes por lotes para las cuentas a las que no tienes acceso.
Causas habituales
Realizar solicitudes en lotes para cuentas secundarias que se borraron o para cuentas secundarias creadas recientemente antes de que estén disponibles
Sugerencias de manipulación recomendadas
Evita realizar llamadas que afecten a una cuenta secundaria borrada.
Sugerencias de prevención
Consulta las sugerencias de manipulación recomendadas.
request_too_large
Resumen
Envías 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 de custombatch, y el límite de tamaño de transferencia comprimido es de 32 MB.
Sugerencias de manipulación recomendadas
Divide el lote en varios lotes que estén por debajo de los límites y 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 manipulación recomendadas
Asegúrate de que el parámetro, aquí price, tenga el formato adecuado. 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 contenía una entrada con "method": "insert", pero sin producto.
Causas habituales
Olvidar cambiar el método a get o delete
Sugerencias de manipulación recomendadas
Especifica un producto para insertar a través del campo product.
Sugerencias de prevención
Asegúrate de que las entradas de lotes con el método
insert especifiquen un producto y de que las entradas de lotes con el método
get o delete especifiquen un ID de producto.
[productId] DELETE request must specify
productId
Resumen
Se envió una solicitud de lote personalizada a la API que contenía una entrada con "method": "delete", pero sin un ID de producto.
Causas habituales
Olvidar cambiar el método a insert
Sugerencias de manipulación recomendadas
Especifica un producto para borrar a través del campo productID.
Sugerencias de prevención
Asegúrate de que las entradas de lotes con el método
insert especifiquen un producto y de que las entradas de 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, se produce un aumento repentino en el tráfico que causa este problema, o bien tu servidor se expande a una mayor cantidad de subprocesos.
Sugerencias de manipulación recomendadas
Reduce la cantidad total de solicitudes
enviadas por minuto. Agrupar varias llamadas a métodos del mismo servicio en una sola solicitud custombatch reducirá la cantidad de solicitudes HTTP que se realicen.
Sugerencias de prevención
Cuando recibas este error, usa estrategias de procesamiento por lotes y de retirada programática para reducir la frecuencia de solicitudes a un nivel adecuado y sostenible.
validación
[adwords_redirect]
Resumen
Envió un producto cuyo campo adwords_redirect no es una URL válida.
Causas habituales
NA
Sugerencias de manipulación 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.
Se envió 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 manipulación recomendadas
Revisa el mensaje para
descubrir qué atributo está causando el problema y, luego, valida la codificación de texto
del valor correspondiente antes de volver a enviar la información. 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: 2026-07-06 (UTC)"],[],["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"]]
