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.
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.
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.
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.
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 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ó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.
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.
[[["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: 2024-07-03 (UTC)"],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],[]]
