Errores comunes

Estos son los errores más comunes:

La siguiente es una lista de errores en orden alfabético.

auth/account_access_denied

User cannot access account <account_number>
ResumenSe emitió una solicitud dirigida a una cuenta a la que el usuario autenticado no tiene acceso.
Causas habitualesError en el ID del comerciante de destino, o bien olvidé registrar al usuario en Merchant Center.
Sugerencias de manejo recomendadasVerifica 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ónN/A
User is not an administrator of account <account_number>
ResumenSe emitió una solicitud para modificar una cuenta para la que el usuario autenticado no tiene derechos de administrador.
Causas habitualesN/A
Sugerencias de manejo recomendadasEstablece los derechos de administrador del usuario autenticado.
Sugerencias de prevenciónN/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>
ResumenSe intentaron realizar varias operaciones en conflicto al mismo tiempo.
Causas habitualesUna 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 recomendadasConsulta las sugerencias de prevención.
Sugerencias de prevenciónContener 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
ResumenHay un problema con el backend de Google.
Causas habitualesN/A
Sugerencias de manejo recomendadasReintenta la solicitud. Comunícate con nosotros si falla constantemente.
Sugerencias de prevenciónN/A

no válido

Invalid channel: '<channel>'
ResumenEl canal que se proporcionó como parte de un ID de producto no es válido. Por ejemplo: not_a_channel:en:US:sku123.
Causas habitualesN/A
Sugerencias de manejo recomendadasN/A
Sugerencias de prevenciónAsegú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>'
ResumenSe 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 habitualesN/A
Sugerencias de manejo recomendadasN/A
Sugerencias de prevenciónAsegú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>'
ResumenEl ID de artículo no es válido (p.ej., sku123 en lugar de online:en:US:sku123.
Causas habitualesEspecificar un ID de oferta en lugar de un ID del producto en una solicitud de GET o DELETE.
Sugerencias de manejo recomendadasN/A
Sugerencias de prevenciónAsegúrate de que el ID del producto tenga el formato channel:languageCode:countryCode:offerId.
[name] The term '<term>' is not allowed
ResumenEl nombre contiene una palabra prohibida.
Causas habitualesN/A
Sugerencias de manejo recomendadasUsa 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ónN/A
[price.currency] Please use a currency that is supported in the target country
ResumenSe especificó una moneda que no está disponible en el país objetivo.
Causas habitualesN/A
Sugerencias de manejo recomendadasAsegú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ónN/A
[storeCode] storeCode must be 'online'
ResumenSe 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 habitualesN/A
Sugerencias de manejo recomendadasCambia el ID de tienda a online en la URL de la solicitud.
Sugerencias de prevenciónAsegú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>]
ResumenEl elemento especificado entre corchetes no es válido.
Causas habitualesN/A
Sugerencias de manejo recomendadasPara 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ónN/A

notFound

Item not found
ResumenEl elemento que intentaste obtener, actualizar o borrar no existe.
Causas habitualesIntentar borrar un producto que no existe o no especificar el ID del producto correctamente en la URL para su eliminación.
Sugerencias de manejo recomendadasObté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ónN/A

not_inserted

The item could not be inserted.
ResumenDebido a otros errores, no se pudo insertar el producto, ya que reemplazaría una entrada válida existente.
Causas habitualesN/A
Sugerencias de manejo recomendadasVerifica 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ónN/A

cuota

too_many_items: Merchant quota exceeded
ResumenSe subieron demasiados artículos a Google Shopping.
Causas habitualesEs 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ónConsulta las Sugerencias de manejo recomendadas.
too_many_subaccounts: Maximum number of subaccounts reached
ResumenTienes la cantidad máxima de cuentas secundarias permitidas para tu cuenta de varios clientes.
Causas habitualesN/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ónN/A
request_rate_too_high: Request rate too high. Please reduce your throughput
ResumenLas solicitudes se realizan demasiado rápido; reduce la frecuencia de las solicitudes.
Causas habitualesConsulta 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 recomendadasReduce el total de solicitudes enviadas por minuto.
Sugerencias de prevenciónCuando 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
ResumenRealizas más solicitudes que la cantidad permitida por día para el método de servicio determinado.
Causas habitualesConsulta 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 Products o Inventory.

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ónConsulta las Sugerencias de manejo recomendadas.
too_many_failed_auths: Too many failed authentications.
ResumenEstás realizando demasiadas solicitudes por lotes para cuentas a las que no tienes acceso.
Causas habitualesRealizar 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 recomendadasEvita hacer llamadas que afecten una cuenta secundaria borrada.
Sugerencias de prevenciónConsulta las Sugerencias de manejo recomendadas.
request_too_large
ResumenEnvías demasiados entries por solicitud por lote o excedes el límite de tamaño de la solicitud de custombatch.
Causas habitualesPuedes 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 recomendadasDivide el lote en varios lotes que estén por debajo de los límites y, luego, vuelve a intentarlo.
Sugerencias de prevenciónTe recomendamos que envíes 1,000 entradas como máximo por lote.

obligatorio

[price.value] Required parameter: price.value
ResumenSe especificó un precio sin valor. Por ejemplo: { "currency": "USD" } en lugar de { "value": 123, "currency": "USD" }.
Causas habitualesN/A
Sugerencias de manejo recomendadasAsegú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ónN/A
[product] INSERT request must specify product
ResumenSe envió una solicitud por lotes personalizada a la API que contiene una entrada con "method": "insert", pero ningún producto.
Causas habitualesOlvidaste cambiar el método a get o delete.
Sugerencias de manejo recomendadasEspecifica el producto que se insertará mediante el campo product.
Sugerencias de prevenciónAsegú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
ResumenSe envió una solicitud por lotes personalizada a la API que contiene una entrada con "method": "delete", pero sin ID del producto.
Causas habitualesSe te olvida cambiar el método a insert.
Sugerencias de manejo recomendadasEspecifica el producto que deseas borrar mediante el campo productID.
Sugerencias de prevenciónAsegú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
ResumenLas solicitudes se realizan demasiado rápido; reduce la frecuencia de las solicitudes.
Causas habitualesConsulta 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 recomendadasReduce 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ónCuando 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]
ResumenEnviaste un producto cuyo campo adwords_redirect no es una URL válida.
Causas habitualesN/A
Sugerencias de manejo recomendadasAsegúrate de que el valor del campo adwords_redirect sea una URL válida.
Sugerencias de prevenciónN/A
[item] auth/frontend/not_claimed
ResumenLa URL del sitio web del comercio no se reclamó en Merchant Center.
Causas habitualesN/A
Sugerencias de manejo recomendadasReclama la URL en Merchant Center. El procedimiento detallado para hacerlo está disponible en el Centro de ayuda.
Sugerencias de prevenciónN/A
[energy_efficiency_class] validation/feed
ResumenSe especificaron energyEfficiencyClass y precios unitarios para el mismo producto.
Causas habitualesN/A
Sugerencias de manejo recomendadasEspecifica solo el nivel de eficiencia energética o el precio unitario, no ambos.
Sugerencias de prevenciónN/A
[item] internal
ResumenUn error interno.
Causas habitualesN/A
Sugerencias de manejo recomendadasReintenta la solicitud. Comunícate con nosotros si falla constantemente.
Sugerencias de prevenciónN/A
[item_group_id] invalid_attribute
ResumenEnviaste un artículo con itemGroupId y muchos valores para un atributo de variante (color, talla, diseño o material).
Causas habitualesEspecificar más de un tamaño para un producto y, al mismo tiempo, especificar un ID de grupo de artículos.
Sugerencias de manejo recomendadasEnvía un producto diferente para cada valor de un atributo de variante determinado, como size.
Sugerencias de prevenciónN/A
[additional_image_link] invalid_attribute
ResumenEnviaste más de 10 vínculos de imagen adicionales.
Causas habitualesN/A
Sugerencias de manejo recomendadasLimita la cantidad de vínculos de imagen adicionales a 10.
Sugerencias de prevenciónN/A
[<attribute>] invalid_character
ResumenEnviaste 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 habitualesN/A
Sugerencias de manejo recomendadasRevisa 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ónN/A
[<attribute>] invalid_value
ResumenEnviaste un color, una descripción o algún otro atributo que no sea válido.
Causas habitualesN/A
Sugerencias de manejo recomendadasAsegú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ónN/A
[<attribute>] missing_recommended / missing_required
ResumenEnviaste un producto sin un atributo obligatorio o recomendado.
Causas habitualesN/A
Sugerencias de manejo recomendadasAsegú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ónN/A
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
ResumenEl producto tiene una URL base que difiere de la que se reclamó en la cuenta de Merchant Center.
Causas habitualesN/A
Sugerencias de manejo recomendadasAsegúrate de que las URLs de los productos enviados coincidan con el sitio web reclamado por Merchant Center.
Sugerencias de prevenciónN/A