Estos son los errores más comunes:
notFound: Elemento no encontradonot_inserted: No se pudo insertar el elemento.[link] validation/invalid_value for <destinations>: Las URLs no pertenecen a tu sitio web.- quota/too_many_items: Se excedió la cuota del comercio.
La siguiente es una lista de errores en orden alfabético.
auth/account_access_denied
User cannot access account
<account_number> |
|
|---|---|
| Resumen | 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 comerciante objetivo, o bien se olvidó registrar al usuario en Merchant Center. |
| Sugerencias de manejo recomendadas | Verifica que estés segmentando la cuenta correcta o regístrate como usuario de la cuenta en Merchant Center (Configuración > Usuarios). |
| Sugerencias de prevención | N/A |
User is not an administrator of
account <account_number> |
|
| Resumen | Emitió una solicitud para modificar una cuenta para la cual el usuario autenticado no tiene derechos de administrador. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Configura los derechos de administrador para el usuario autenticado. |
| Sugerencias de prevención | N/A |
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 bien varias operaciones en conflicto para el mismo producto se enviaron a Content API al mismo tiempo. |
| Sugerencias de manejo recomendadas | Consulta las sugerencias de prevención. |
| Sugerencias de prevención | Contener todos los cambios de un producto determinado en una sola operación de 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. |
internalError
Internal error |
|
|---|---|
| Resumen | Hay un problema con el backend de Google. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Reintenta la solicitud. Cuéntanos de ella en el foro si falla de manera constante. |
| Sugerencias de prevención | N/A |
no válido
Invalid channel:
'<channel>' |
|
|---|---|
| Resumen | Se proporcionó un canal no válido como parte de un ID del producto.
Por ejemplo: not_a_channel:en:US:sku123. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | N/A |
| 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 del producto.
Por ejemplo: online:en:not_a_country_code:sku123. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | N/A |
| Sugerencias de prevención | Asegúrate de que el ID del producto tenga el formato channel:languageCode:countryCode:offerId y 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 del producto en una solicitud GET o DELETE |
| Sugerencias de manejo recomendadas | N/A |
| Sugerencias de prevención | Asegúrate de que el ID del producto tenga el formato channel:languageCode:countryCode:offerId. |
[name] The term '<term>' is not
allowed |
|
| Resumen | El nombre contiene una palabra prohibida. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Usa un nombre permitido. Consulta el artículo del Centro de ayuda sobre la especificación de feeds para obtener más información. |
| Sugerencias de prevención | N/A |
[price.currency] Please use a currency
that is supported in the target country |
|
| Resumen | Se especificó una moneda que no está disponible en el país de segmentación. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Asegúrate de que la moneda
y el país se especifiquen correctamente. Consulta la sección sobre price en el artículo del Centro de ayuda sobre la especificación de feeds para obtener más información. |
| Sugerencias de prevención | N/A |
[storeCode] storeCode must be
'online' |
|
| Resumen | Intentaste actualizar el precio y la disponibilidad de un producto en línea a través del feed de inventario, pero especificaste algo diferente al valor especial online como ID de tienda en la URL. |
| Causas habituales | N/A |
| 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 las consultas de inventario. |
[<attribute>] |
|
| Resumen | El elemento especificado entre corchetes no es válido. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Para obtener más información, consulta el artículo del Centro de ayuda sobre la especificación de feeds para corregir la especificación del elemento con problemas. |
| Sugerencias de prevención | N/A |
notFound
Item not found |
|
|---|---|
| Resumen | El elemento que intentaste obtener, actualizar o borrar no existe. |
| Causas habituales | Intentar borrar un producto que no existe o no especificar correctamente el ID del producto 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 con el formato channel:languageCode:countryCode:offerId, por ejemplo: online:ru:RU:277104-ekb, en lugar del ID de oferta, que es similar al siguiente: 277104-ekb. |
| Sugerencias de prevención | N/A |
not_inserted
The item could not be
inserted. |
|
|---|---|
| Resumen | Debido a otros errores, no se pudo insertar el producto, ya que reemplazaría una entrada válida existente. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Revisa los demás errores de la misma llamada y resuélvelos antes de intentar volver a insertar la información del producto nuevo. |
| Sugerencias de prevención | N/A |
quota
too_many_items: Merchant
quota exceeded |
|
|---|---|
| Resumen | Se subieron demasiados artículos a Google Shopping. |
| Causas habituales | Es posible que los productos que no se validen se inserten de todos modos si no reemplazan uno 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 | Comprueba si hay una cantidad excesiva de productos no válidos y quítala, tal 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 30 días después de la inserción o actualización de productos. Nota: La cuota de artículos de una cuenta de varios clientes se compara con la cantidad total de productos en todas las cuentas secundarias. Si recibes este error con una cuenta secundaria, asegúrate de que tanto ella como tu MCA tengan suficiente cuota de productos. Si probaste estas soluciones y aún te estás quedando sin espacio para productos nuevos en tu cuenta de Merchant Center, puedes solicitar la capacidad de enviar más artículos a tu cuenta. |
| Sugerencias de prevención | Consulta las Sugerencias de manejo recomendadas. |
too_many_subaccounts:
Maximum number of subaccounts reached |
|
| Resumen | Alcanzaste la cantidad máxima de cuentas secundarias permitidas para tu cuenta de varios clientes. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Borra las cuentas secundarias obsoletas. Si todas tus cuentas están activas, puedes solicitar la capacidad de crear cuentas secundarias adicionales en tu MCA. |
| Sugerencias de prevención | N/A |
request_rate_too_high:
Request rate too high. Please reduce your throughput |
|
| Resumen | Las solicitudes se realizan demasiado rápido. Reduce su frecuencia. |
| Causas habituales | Consulta las cuotas por minuto que se indican en los límites publicados. Si superas estos límites, recibirás este error. A veces, se produce un aumento repentino en el tráfico o tu servidor se expande a una mayor cantidad de subprocesos. |
| Sugerencias de manejo recomendadas | Reduce el total de solicitudes que se envían por minuto. |
| Sugerencias de prevención | Cuando recibas este error, usa estrategias de retirada programática para reducir el porcentaje de solicitudes a un nivel sostenible adecuado. |
daily_limit_exceeded:
merchant quota exceeded |
|
| Resumen | Realizas más solicitudes que la cantidad permitida por día 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 límites, recibirás este error. |
| Sugerencias de manejo recomendadas | Reduce el total de solicitudes que se envían por día combinando varios cambios en una sola solicitud siempre que sea posible. Considera agrupar los cambios en los productos durante un período adecuado
para evitar cambiar rápidamente un producto varias veces. En el caso de las actualizaciones de artículos que se pueden representar como microdatos en el sitio web, considera usar ese enfoque para limitar la cantidad de llamadas a los servicios Si aún necesitas más llamadas diarias a un método determinado, comunícate con nosotros para proporcionarnos tu ID de Merchant Center, los métodos con los que estás alcanzando los límites de cuota, una estimación de la cantidad de llamadas que necesitarás por día para esos métodos y el motivo, y 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 | Estás realizando demasiadas solicitudes por lotes para las cuentas a las que no tienes acceso. |
| Causas habituales | Realizar solicitudes en lotes para las cuentas secundarias que se borraron o las 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 | Envías demasiados entries por solicitud por lotes o
excedes el límite de tamaño de la solicitud custombatch. |
| Causas habituales | Puedes incluir un máximo de 10,000 entries por solicitud custombatch, y el límite de tamaño de transferencia comprimida es de 32 MB. |
| Sugerencias de manejo recomendadas | Divide el lote en varios que estén por debajo de los límites y, luego, vuelve a intentarlo. |
| Sugerencias de prevención | Te recomendamos que envíes no más de 1,000 entradas por lote. |
obligatorio
[price.value] Required parameter: price.value |
|
|---|---|
| Resumen | Especificaste un precio sin valor. Por ejemplo: { "currency": "USD" } en lugar de { "value": 123, "currency": "USD" }. |
| Causas habituales | N/A |
| 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 | N/A |
[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 ningún producto. |
| Causas habituales | Olvidaste cambiar el método a get o delete. |
| Sugerencias de manejo recomendadas | Especifica un producto para
insertar en el campo product. |
| Sugerencias de prevención | Asegúrate de que las entradas por lotes con el método
insert especifiquen un producto y 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
del producto. |
| Causas habituales | Olvidaste cambiar el método a insert. |
| Sugerencias de manejo recomendadas | Especifica el producto que quieres borrar en el campo productID. |
| Sugerencias de prevención | Asegúrate de que las entradas por lotes con el método
insert especifiquen un producto y las entradas por lotes con el método get
o
delete especifiquen un ID de producto. |
userRateLimitExceeded
User Rate Limit
Exceeded |
|
|---|---|
| Resumen | Las solicitudes se realizan demasiado rápido. Reduce su frecuencia. |
| Causas habituales | Consulta los límites de solicitudes HTTP que se enumeran en los límites publicados. Si superas estos límites, 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 manejo recomendadas | Reduce el total de solicitudes que se envían por minuto. Si se agrupan varias llamadas de método al mismo servicio en una sola solicitud custombatch, se reducirá la cantidad de solicitudes HTTP que se realizan. |
| Sugerencias de prevención | Cuando recibas este error, usa estrategias de retirada programática y por lotes para reducir el porcentaje de solicitudes a un nivel sostenible adecuado. |
la validación de políticas
[adwords_redirect] |
|
|---|---|
| Resumen | Envió un producto cuyo campo adwords_redirect no es una URL válida. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Asegúrate de que el valor del campo
adwords_redirect sea una URL válida. |
| Sugerencias de prevención | N/A |
[item] auth/frontend/not_claimed |
|
| Resumen | La URL del sitio web del comercio no se reclamó en Merchant Center. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Reclama la URL en Merchant Center. Puedes consultar el procedimiento detallado para hacerlo en el Centro de ayuda. |
| Sugerencias de prevención | N/A |
[energy_efficiency_class]
validation/feed |
|
| Resumen | Se especificaron energyEfficiencyClass y
precios por unidad para el mismo producto. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Especifica solo el nivel de eficiencia energética o el precio unitario, no ambos. |
| Sugerencias de prevención | N/A |
[item] internal |
|
| Resumen | Se produjo un error interno. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Reintenta la solicitud. Cuéntanos en el foro si falla con frecuencia. |
| Sugerencias de prevención | N/A |
[item_group_id] invalid_attribute |
|
| Resumen | Se envió un artículo con itemGroupId y muchos valores para un atributo de variante (color, tamaño, diseño o material). |
| Causas habituales | Especificar más de un tamaño para un producto y, al mismo tiempo, especificar un ID de grupo de artículos. |
| Sugerencias de manejo recomendadas | Envía un producto
diferente para cada valor de un atributo de variante determinado, como
size. |
| Sugerencias de prevención | N/A |
[additional_image_link]
invalid_attribute |
|
| Resumen | Enviaste más de 10 vínculos de imagen adicionales. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Limita la cantidad de vínculos de imagen adicionales a 10. |
| Sugerencias de prevención | N/A |
[<attribute>] invalid_character |
|
| Resumen | Se envió una marca, una descripción o algún otro atributo como una cadena que no se analiza mediante la codificación de solicitud especificada. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Revisa el mensaje para averiguar cuál es el atributo que causa 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 | N/A |
[<attribute>] invalid_value |
|
| Resumen | Enviaste un color, una descripción o algún otro atributo que no es válido. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Asegurarse de que todos los atributos cumplan con la especificación del feed. Para obtener más información, consulte el artículo del Centro de ayuda sobre la especificación de feeds. Si tienes problemas con los GTIN o MPN, consulta el artículo del Centro de ayuda sobre identificadores únicos de productos. |
| Sugerencias de prevención | N/A |
[<attribute>]
missing_recommended / missing_required |
|
| Resumen | Se envió un producto sin un atributo obligatorio/recomendado. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Asegúrate de incluir todos los atributos obligatorios o recomendados para tu producto. Consulta el artículo del Centro de ayuda sobre la especificación de feeds para obtener más información. |
| Sugerencias de prevención | N/A |
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website |
|
| Resumen | Se envió un producto con una URL base que difiere de la URL reclamada por la cuenta de Merchant Center. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Asegúrate de que las URLs de los productos enviados coincidan con el sitio web reclamado por Merchant Center. |
| Sugerencias de prevención | N/A |