Estos son los errores más comunes:
notFound: No se encontró el elemento.not_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 comerciante.
La siguiente es 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 | Error en el ID del comerciante de destino, o bien olvidé registrar al usuario en Merchant Center. |
| Sugerencias de manejo recomendadas | Verifica si segmentas tus anuncios para 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 | Se emitió una solicitud para modificar una cuenta para la que el usuario autenticado no tiene derechos de administrador. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Establece los derechos de administrador del 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 realizar varias operaciones en conflicto al mismo tiempo. |
| Causas habituales | Una sola solicitud por lotes contiene varias operaciones en conflicto para el mismo producto o varias operaciones en conflicto para el mismo producto que se enviaron a la 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 a una sola operación en un conjunto de solicitudes por lotes Intenta evitar 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. Comunícate con nosotros si falla constantemente. |
| Sugerencias de prevención | N/A |
no válido
Invalid channel:
'<channel>' |
|
|---|---|
| Resumen | El canal que se proporcionó como parte de un ID de producto no es válido.
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 de 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 | El ID de artículo no es 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 de 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. Para obtener más información, consulta el artículo del Centro de ayuda sobre la especificación de feeds. |
| 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 objetivo. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Asegúrate de que la moneda
y el país estén especificados correctamente. Para obtener más información, consulta la sección sobre price del artículo del Centro de ayuda sobre la especificación de feeds. |
| Sugerencias de prevención | N/A |
[storeCode] storeCode must be
'online' |
|
| Resumen | Se intentó actualizar el precio y la disponibilidad de un
producto en línea mediante el feed de inventario, pero se especificó algo distinto al
valor especial online como el 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 tus
consultas de inventario. |
[<attribute>] |
|
| Resumen | El elemento especificado entre corchetes no es válido. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Para corregir la especificación del elemento con problemas, 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 |
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 el ID del producto correctamente en la URL para su eliminación. |
| 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 se ve de la siguiente manera: 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 | Verifica los demás errores de la misma llamada y corrígelos antes de intentar volver a insertar la información del producto nuevo. |
| Sugerencias de prevención | N/A |
cuota
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 de todos modos se
inserten 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 | Verifica y quita una 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 compara con la cantidad total de productos de todas las cuentas secundarias. Si recibes este error con una cuenta secundaria, asegúrate de que tanto la cuenta secundaria como tu MCA tengan suficiente cuota de producto. Si intentaste estas soluciones y aún no tienes espacio para productos nuevos en tu cuenta de Merchant Center, puedes solicitar la capacidad de enviar más artículos en tu cuenta. |
| Sugerencias de prevención | Consulta las Sugerencias de manejo recomendadas. |
too_many_subaccounts:
Maximum number of subaccounts reached |
|
| Resumen | Tienes 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 la frecuencia de las solicitudes. |
| Causas habituales | Consulta las cuotas por minuto que se enumeran en los límites publicados. Si superas estos umbrales, recibirás este error. A veces, esto se debe a un aumento repentino de tráfico o a tu servidor se expande a una cantidad mayor de subprocesos. |
| Sugerencias de manejo recomendadas | Reduce el total de solicitudes enviadas 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 enumeradas en los límites publicados. Si superas estos umbrales, recibirás este error. |
| Sugerencias de manejo recomendadas | Reduce el total de solicitudes enviadas por día mediante la combinación de varios cambios en una sola solicitud cuando 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 tu 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 e indícanos tu ID de Merchant Center, los métodos en los que alcanzaste 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 la 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 cuentas a las que no tienes acceso. |
| Causas habituales | Realizar solicitudes en 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 hacer llamadas que afecten 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 lote o excedes 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 envíes 1,000 entradas como máximo 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 | 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 el producto que se insertará mediante el campo product. |
| Sugerencias de prevención | Asegúrate de que las entradas de lote con el método
insert especifiquen un producto y que las entradas de lote con el método get
o
delete especifiquen un ID del 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 ID del producto. |
| Causas habituales | Se te olvida cambiar el método a insert. |
| Sugerencias de manejo recomendadas | Especifica el producto que deseas borrar mediante el campo productID. |
| Sugerencias de prevención | Asegúrate de que las entradas de lote con el método
insert especifiquen un producto y que las entradas de lote con el método get
o
delete especifiquen un ID del producto. |
userRateLimitExceeded
User Rate Limit
Exceeded |
|
|---|---|
| Resumen | Las solicitudes se realizan demasiado rápido; reduce la frecuencia de las solicitudes. |
| Causas habituales | Consulta los límites de solicitudes HTTP que se enumeran en los límites publicados. Si superas estos umbrales, recibirás este error. A veces, esto se debe a un aumento repentino de tráfico o a tu servidor se expande a una cantidad mayor de subprocesos. |
| Sugerencias de manejo recomendadas | Reduce el total de solicitudes enviadas por minuto. Agrupar en lotes varias llamadas a métodos 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 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 | Enviaste 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. El procedimiento detallado para hacerlo está disponible en el Centro de ayuda. |
| Sugerencias de prevención | N/A |
[energy_efficiency_class]
validation/feed |
|
| Resumen | Se especificaron energyEfficiencyClass y
precios unitarios 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 | Un error interno. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Reintenta la solicitud. Comunícate con nosotros si falla constantemente. |
| Sugerencias de prevención | N/A |
[item_group_id] invalid_attribute |
|
| Resumen | Enviaste un artículo con itemGroupId y muchos valores para un atributo de variante (color, talla, 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 | Enviaste 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 qué atributo está causando el problema. 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 sea válido. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Asegúrate de que todos los atributos cumplan con la especificación del feed. Consulta el artículo del Centro de ayuda sobre las especificaciones de feeds para obtener más información. Si tienes problemas con el GTIN o el MPN, consulta el artículo sobre identificadores únicos de producto del Centro de ayuda. |
| Sugerencias de prevención | N/A |
[<attribute>]
missing_recommended / missing_required |
|
| Resumen | Enviaste un producto sin un atributo obligatorio o recomendado. |
| Causas habituales | N/A |
| Sugerencias de manejo recomendadas | Asegúrate de incluir todos los atributos obligatorios y recomendados para tu producto. Para obtener más información, consulta el artículo del Centro de ayuda sobre la especificación de feeds. |
| Sugerencias de prevención | N/A |
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website |
|
| Resumen | El producto tiene una URL base que difiere de la que se reclamó en 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 |