Errores comunes

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 superó la cuota de comercios.

A continuación, se incluye una lista de errores en orden alfabético.

Nota: Si tienes problemas relacionados con la calidad de los datos o la suspensión de la cuenta, que son independientes de Content API for Shopping, consulta Cómo comprender la aplicación de políticas a nivel de la cuenta por incumplimientos en los datos de productos. También puedes ver las solicitudes erróneas a través del panel de la API.

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.

internalError

Internal error
Resumen	Hay un problema con el backend de Google.
Causas habituales	NA
Sugerencias de manipulación recomendadas	Reintenta la solicitud. Comunícate con nosotros si falla de manera constante.
Sugerencias de prevención	NA

no válido

Invalid channel: '<channel>'
Resumen	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.
[name] The term '<term>' is not allowed
Resumen	El nombre contiene una palabra prohibida.
Causas habituales	NA
Sugerencias de manipulación recomendadas	Usa un nombre permitido. Consulta el artículo del Centro de ayuda sobre las especificaciones de feeds para obtener más información.
Sugerencias de prevención	NA
[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	NA
Sugerencias de manipulación recomendadas	Asegúrate de que la moneda y el país estén especificados correctamente. Consulta la sección sobre price en el artículo del Centro de ayuda sobre las especificaciones de feeds para obtener más información.
Sugerencias de prevención	NA
[storeCode] storeCode must be 'online'
Resumen	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.
Causas habituales	NA
Sugerencias de manipulación recomendadas	Corrige la especificación del artículo problemático. Para obtener más información, consulta el artículo del Centro de ayuda sobre las especificaciones del feed.
Sugerencias de prevención	NA

notFound

Item not found
Resumen	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. Si probaste estas soluciones y sigues sin tener espacio para agregar 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 manipulación 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	NA
Sugerencias de manipulación 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	NA
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.
Causas habituales	NA
Sugerencias de manipulación recomendadas	Reclama la URL en Merchant Center. El procedimiento detallado para hacerlo está disponible en el Centro de ayuda.
Sugerencias de prevención	NA
[energy_efficiency_class] validation/feed
Resumen	Se especificaron tanto el energyEfficiencyClass como el precio unitario para el mismo producto.
Causas habituales	NA
Sugerencias de manipulación recomendadas	Especifica solo la clase de eficiencia energética o el precio por unidad, no ambos.
Sugerencias de prevención	NA
[item] internal
Resumen	Se produjo un error interno.
Causas habituales	NA
Sugerencias de manipulación recomendadas	Reintenta la solicitud. Comunícate con nosotros si falla de manera constante.
Sugerencias de prevención	NA
[item_group_id] invalid_attribute
Resumen	Enviamos 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 manipulación recomendadas	Envía un producto diferente para cada valor de un atributo de variante determinado, como size.
Sugerencias de prevención	NA
[additional_image_link] invalid_attribute
Resumen	Se enviaron más de 10 vínculos de imagen adicionales.
Causas habituales	NA
Sugerencias de manipulación recomendadas	Limita la cantidad de vínculos de imagen adicionales a 10.
Sugerencias de prevención	NA
[<attribute>] invalid_character
Resumen	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.
Causas habituales	NA
Sugerencias de manipulación recomendadas	Asegúrate de que todos los atributos cumplan con las especificaciones del feed. Para obtener más información, consulta el artículo del Centro de ayuda sobre las especificaciones del feed. Si tienes problemas con el GTIN o el MPN, consulta el artículo del Centro de ayuda sobre los identificadores únicos de producto.
Sugerencias de prevención	NA
[<attribute>] missing_recommended de missing_required
Resumen	Se envió un producto sin un atributo obligatorio o recomendado.
Causas habituales	NA
Sugerencias de manipulación recomendadas	Asegúrate de incluir todos los atributos recomendados o obligatorios para tu producto. Consulta el artículo del Centro de ayuda sobre las especificaciones de feeds para obtener más información.
Sugerencias de prevención	NA
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
Resumen	Se envió un producto con una URL base diferente de la URL reclamada por la cuenta de Merchant Center.
Causas habituales	NA
Sugerencias de manipulación recomendadas	Asegúrate de que las URLs de los productos enviados coincidan con el sitio web que reclamó Merchant Center.
Sugerencias de prevención	NA