Erreurs courantes

Voici les erreurs les plus courantes:

• notFound: article introuvable.
• not_inserted: impossible d'insérer l'article.
• [link] validation/invalid_value for <destinations> : URL n'appartenant pas à votre site Web.
• quota/too_many_items::quota Merchant Center dépassé.

Voici une liste d'erreurs classées par ordre alphabétique.

Remarque :Pour en savoir plus sur les problèmes de qualité des données ou les suspensions de compte, qui sont indépendants de Content API for Shopping, consultez l'article Comprendre les mesures d'application au niveau du compte en cas de non-respect des données produit. Vous pouvez également afficher les requêtes incorrectes via le tableau de bord de l'API.

auth/accès_au_compte_refusé

User cannot access account <account_number>
Résumé	Envoi d'une requête ciblant un compte auquel l'utilisateur authentifié n'a pas accès.
Causes courantes	Erreur de saisie de l'ID du marchand cible ou oubli d'enregistrement de l'utilisateur dans Merchant Center.
Conseils de résolution	Vérifiez que vous ciblez le bon compte ou enregistrez-vous en tant qu'utilisateur du compte dans Merchant Center (Paramètres > Utilisateurs).
Conseils de prévention	NA
User is not an administrator of account <account_number>
Résumé	Envoi d'une requête de modification d'un compte sur lequel l'utilisateur authentifié ne dispose d'aucun droit d'administration.
Causes courantes	NA
Conseils de résolution	Accordez des droits d'administration à l'utilisateur authentifié.
Conseils de prévention	NA

conflit

[productId] Product ID <product id> is already modified by another entry in the same request for merchant <merchant> and store code <store code>
Résumé	Tentative d'exécution simultanée de plusieurs opérations en conflit.
Causes courantes	Une requête par lot contient plusieurs opérations en conflit pour un même produit, ou plusieurs opérations en conflit sur un même produit ont été envoyées à Content API en même temps.
Conseils de résolution	Consultez les conseils de prévention.
Conseils de prévention	Apportez toutes les modifications sur un produit donné en une seule opération dans un ensemble de requêtes par lot. Évitez d'effectuer plusieurs appels simultanés à Content API pour le même code de magasin et marchand, ou vérifiez que ces appels ne contiennent pas de produits qui se chevauchent.

internalError

Internal error
Résumé	Le backend de Google rencontre un problème.
Causes courantes	NA
Conseils de résolution	Réessayez d'envoyer la requête. Contactez-nous si le problème persiste.
Conseils de prévention	NA

non valide

Invalid channel: '<channel>'
Résumé	Un canal non valide a été indiqué dans un ID produit. Par exemple: not_a_channel:en:US:sku123.
Causes courantes	NA
Conseils de résolution	NA
Conseils de prévention	Assurez-vous que votre ID produit respecte le format channel:languageCode:countryCode:offerId, par exemple : online:en:US:sku123. Pour en savoir plus, consultez la documentation de référence sur Products.insert.
[countrycode] Invalid country code: '<country_code>'
Résumé	Code pays non valide indiqué dans un ID produit. Par exemple: online:en:not_a_country_code:sku123.
Causes courantes	NA
Conseils de résolution	NA
Conseils de prévention	Assurez-vous que votre ID produit respecte le format channel:languageCode:countryCode:offerId et que le code pays correspond à un code ISO 3166 valide.
[item id] Invalid item id: '<id>'
Résumé	ID d'article non valide, par exemple sku123 au lieu de online:en:US:sku123.
Causes courantes	Spécification d'un identifiant d'offre au lieu d'un ID produit dans une requête GET ou DELETE.
Conseils de résolution	NA
Conseils de prévention	Assurez-vous que votre ID produit respecte le format channel:languageCode:countryCode:offerId.
[name] The term '<term>' is not allowed
Résumé	Le nom contient un mot interdit.
Causes courantes	NA
Conseils de résolution	Utilisez un nom autorisé. Consultez l'article du centre d'aide Spécifications des données produit pour en savoir plus.
Conseils de prévention	NA
[price.currency] Please use a currency that is supported in the target country
Résumé	Une devise non disponible dans le pays cible a été spécifiée.
Causes courantes	NA
Conseils de résolution	Assurez-vous que la devise et le pays sont correctement spécifiés. Pour en savoir plus, consultez la section sur l'attribut price dans l'article "Spécifications des données produit" du centre d'aide.
Conseils de prévention	NA
[storeCode] storeCode must be 'online'
Résumé	Vous avez essayé de mettre à jour le prix et la disponibilité d'un produit en ligne via le flux d'inventaire, mais vous avez spécifié une valeur autre que la valeur spéciale online comme identifiant de magasin dans l'URL.
Causes courantes	NA
Conseils de résolution	Définissez l'ID du magasin sur online dans l'URL de la requête.
Conseils de prévention	Assurez-vous de spécifier online pour les produits en ligne et l'identifiant du magasin pour les produits en magasin dans toutes vos requêtes d'inventaire.
[<attribute>]
Résumé	L'élément spécifié entre crochets n'est pas valide.
Causes courantes	NA
Conseils de résolution	Corrigez les spécifications de l'élément concerné par le problème. Consultez l'article du centre d'aide Spécifications des données produit pour en savoir plus.
Conseils de prévention	NA

notFound

Item not found
Résumé	L'article que vous avez essayé d'obtenir, de mettre à jour ou de supprimer n'existe pas.
Causes courantes	Tentative de suppression d'un produit qui n'existe pas, ou ID produit incorrect dans l'URL de la requête de suppression.
Conseils de résolution	Récupérez la liste des produits à l'aide de la méthode Products.list, puis essayez d'obtenir, de mettre à jour ou de supprimer uniquement les articles y figurant. Assurez-vous que l'ID produit respecte le format channel:languageCode:countryCode:offerId (par exemple, online:ru:RU:277104-ekb) et non un identifiant d'offre du type 277104-ekb.
Conseils de prévention	NA

not_inserted

The item could not be inserted.
Résumé	En raison d'autres erreurs, le produit n'a pas pu être inséré, car il remplacerait une entrée valide existante.
Causes courantes	NA
Conseils de résolution	Examinez les autres erreurs détectées pour le même appel, puis corrigez-les avant d'essayer de réinsérer les nouvelles informations sur le produit.
Conseils de prévention	NA

quota

too_many_items: Merchant quota exceeded
Résumé	Trop d'articles importés sur Google Shopping.
Causes courantes	Les produits dont la validation a échoué peuvent quand même être insérés s'ils ne remplacent pas un produit valide existant. Utilisez l'indicateur includeInvalidInsertedItems dans la méthode Productstatuses.list pour vous assurer que votre compte ne contient pas un trop grand nombre de produits non valides.
Conseils de résolution	Vérifiez si votre compte contient de trop nombreux produits non valides et supprimez-les comme indiqué ci-dessus. De plus, définissez des dates d'expiration lorsque vous importez vos produits. À la date d'expiration, le produit est automatiquement supprimé. N'oubliez pas que la date d'expiration par défaut est de 30 jours maximum après l'insertion ou la mise à jour du produit. Remarque: Le quota d'articles pour un multicompte est comparé au nombre total de produits dans l'ensemble des sous-comptes. Si vous rencontrez cette erreur avec un sous-compte, assurez-vous que celui-ci et votre multicompte disposent d'un quota de produits suffisant. Si vous avez essayé ces solutions, mais que l'espace disponible pour les nouveaux produits dans votre compte Merchant Center reste insuffisant, vous pouvez demander à augmenter le nombre d'articles pouvant être envoyés dans votre compte.
Conseils de prévention	Consultez la section Conseils de traitement.
too_many_subaccounts: Maximum number of subaccounts reached
Résumé	Vous avez atteint le nombre maximal de sous-comptes autorisé pour votre multicompte.
Causes courantes	NA
Conseils de résolution	Supprimez les sous-comptes obsolètes. Si tous vos comptes sont actifs, vous pouvez demander la création de sous-comptes supplémentaires dans votre multicompte.
Conseils de prévention	NA
request_rate_too_high: Request rate too high. Please reduce your throughput
Résumé	Les requêtes sont envoyées trop rapidement. Veuillez réduire la fréquence des requêtes.
Causes courantes	Consultez les quotas par minute présentés dans les limites publiées. Si vous dépassez ces quotas, cette erreur apparaît. Elle peut être due à un pic de trafic ou à l'expansion de votre serveur à plus grand nombre de threads.
Conseils de résolution	Réduisez le nombre total de requêtes envoyées par minute.
Conseils de prévention	Si vous rencontrez cette erreur, mettez en place des stratégies programmatiques en arrière-plan pour réduire votre taux de requêtes à un niveau approprié sur le long terme.
daily_limit_exceeded: merchant quota exceeded
Résumé	Vous dépassez le nombre de requêtes autorisé par jour pour la méthode de service donnée.
Causes courantes	Consultez les quotas par jour présentés dans les limites publiées. Si vous dépassez ces quotas, cette erreur apparaît.
Conseils de résolution	Réduisez le nombre total de requêtes envoyées par jour en combinant plusieurs modifications dans une seule requête lorsque cela est possible. Envisagez de modifier vos produits par lot sur une période appropriée pour éviter de modifier trop souvent vos produits plusieurs fois. Pour les mises à jour d'articles pouvant être représentées sous forme de microdonnées sur votre site Web, utilisez cette méthode pour limiter le nombre d'appels aux services Products ou Inventory. Si vous avez besoin d'un plus grand nombre d'appels quotidiens pour une méthode donnée, veuillez nous contacter et nous indiquer votre ID Merchant Center, les méthodes pour lesquelles vous atteignez votre quota, une estimation du nombre d'appels par jour dont vous aurez besoin pour ces méthodes et pourquoi. Nous vous aiderons à augmenter votre quota.
Conseils de prévention	Consultez la section Conseils de traitement.
too_many_failed_auths: Too many failed authentications.
Résumé	Vous exécutez trop de requêtes par lot pour des comptes auxquels vous n'avez pas accès.
Causes courantes	Effectuer des requêtes par lot pour des sous-comptes supprimés ou nouvellement créés avant qu'ils ne soient disponibles
Conseils de résolution	Évitez d'effectuer des appels qui affectent un sous-compte supprimé.
Conseils de prévention	Consultez la section Conseils de traitement.
request_too_large
Résumé	Vous envoyez trop d'entries par requête de lot ou vous dépassez la taille limite de requête custombatch.
Causes courantes	Vous pouvez inclure jusqu'à 10 000 entries par requête custombatch, et la taille limite de transfert compressé est de 32 Mo.
Conseils de résolution	Divisez le lot en plusieurs lots d'une taille inférieure aux limites, puis réessayez.
Conseils de prévention	Nous vous recommandons de ne pas envoyer plus de 1 000 entrées par lot.

sans nécessiter de provisionnement.

[price.value] Required parameter: price.value
Résumé	Aucune valeur spécifiée pour le prix. Par exemple, vous avez spécifié { "currency": "USD" } au lieu de { "value": 123, "currency": "USD" }.
Causes courantes	NA
Conseils de résolution	Assurez-vous que le paramètre price est correctement défini. Par exemple, price comporte deux champs obligatoires: value et currency.
Conseils de prévention	NA
[product] INSERT request must specify product
Résumé	Une requête par lot personnalisée a été envoyée à l'API avec une entrée contenant "method": "insert", mais aucun produit.
Causes courantes	Vous avez oublié de remplacer la méthode par get ou delete.
Conseils de résolution	Spécifiez un produit à insérer via le champ product.
Conseils de prévention	Assurez-vous que les entrées du lot dotées de la méthode insert spécifient bien un produit, et que celles dotées des méthodes get ou delete spécifient un ID produit.
[productId] DELETE request must specify productId
Résumé	Une requête par lot personnalisée a été envoyée à l'API avec une entrée contenant "method": "delete", mais aucun ID produit.
Causes courantes	Vous avez oublié de remplacer la méthode par insert.
Conseils de résolution	Spécifiez un produit à supprimer via le champ productID.
Conseils de prévention	Assurez-vous que les entrées du lot dotées de la méthode insert spécifient bien un produit, et que celles dotées des méthodes get ou delete spécifient un ID produit.

userRateLimitExceeded

User Rate Limit Exceeded
Résumé	Les requêtes sont envoyées trop rapidement. Veuillez réduire la fréquence des requêtes.
Causes courantes	Consultez les limites concernant les requêtes HTTP présentées dans les limites publiées. Si vous dépassez ces quotas, cette erreur apparaît. Elle peut être due à un pic de trafic ou à l'expansion de votre serveur à un plus grand nombre de threads.
Conseils de résolution	Réduisez le nombre total de requêtes envoyées par minute. En regroupant plusieurs appels de la méthode vers le même service dans une seule requête custombatch, vous pouvez réduire le nombre de requêtes HTTP.
Conseils de prévention	Si vous rencontrez cette erreur, mettez en place des stratégies programmatiques et par lot en arrière-plan pour réduire votre taux de requêtes à un niveau approprié sur le long terme.

en automatisant la validation des règles ;

[adwords_redirect]
Résumé	Un produit dont le champ adwords_redirect ne correspond pas à une URL valide a été envoyé.
Causes courantes	NA
Conseils de résolution	Assurez-vous que la valeur du champ adwords_redirect correspond à une URL valide.
Conseils de prévention	NA
[item] auth/frontend/not_claimed
Résumé	L'URL du site Web du marchand n'a pas été revendiquée dans Merchant Center.
Causes courantes	NA
Conseils de résolution	Revendiquez l'URL de votre site dans Merchant Center. Vous trouverez la procédure détaillée dans le Centre d'aide.
Conseils de prévention	NA
[energy_efficiency_class] validation/feed
Résumé	L'attribut energyEfficiencyClass et le prix unitaire ont été spécifiés pour un même produit.
Causes courantes	NA
Conseils de résolution	Spécifiez uniquement la classe énergétique ou le prix unitaire, et non les deux à la fois.
Conseils de prévention	NA
[item] internal
Résumé	Erreur interne.
Causes courantes	NA
Conseils de résolution	Réessayez d'envoyer la requête. Contactez-nous si le problème persiste.
Conseils de prévention	NA
[item_group_id] invalid_attribute
Résumé	Un article a été envoyé avec à la fois un attribut itemGroupId et de nombreuses valeurs pour un attribut de variante (couleur, taille, motif ou matière).
Causes courantes	Vous avez spécifié plusieurs tailles pour un produit tout en spécifiant un identifiant de groupe d'articles.
Conseils de résolution	Envoyez un produit différent pour chaque valeur d'un attribut de variante donné, comme size.
Conseils de prévention	NA
[additional_image_link] invalid_attribute
Résumé	Envoi de plus de 10 liens image supplémentaires.
Causes courantes	NA
Conseils de résolution	Limitez le nombre de liens image supplémentaires à 10.
Conseils de prévention	NA
[<attribute>] invalid_character
Résumé	Une marque, une description ou un autre attribut a été envoyé en tant que chaîne qui ne peut être analysée avec l'encodage de requête spécifié.
Causes courantes	NA
Conseils de résolution	Consultez le message pour identifier l'attribut à l'origine du problème, puis validez l'encodage du texte de la valeur correspondante avant de la renvoyer. L'API n'accepte que les caractères UTF-8 valides.
Conseils de prévention	NA
[<attribute>] invalid_value
Résumé	Envoi d'une couleur, d'une description ou d'un autre attribut non valide.
Causes courantes	NA
Conseils de résolution	Vérifiez que tous les attributs sont conformes aux spécifications techniques du flux. Consultez l'article du centre d'aide Spécifications des données produit pour en savoir plus. Pour les problèmes liés au code GTIN ou à la référence fabricant, consultez l'article du centre d'aide À propos des codes produit uniques.
Conseils de prévention	NA
[<attribute>] missing_recommended / missing_required
Résumé	Envoi d'un produit sans attribut obligatoire/recommandé.
Causes courantes	NA
Conseils de résolution	Assurez-vous d'inclure tous les attributs recommandés / obligatoires pour votre produit. Consultez l'article du centre d'aide Spécifications des données produit pour en savoir plus.
Conseils de prévention	NA
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
Résumé	Envoi d'un produit avec une URL de base différente de celle revendiquée par le compte Merchant Center.
Causes courantes	NA
Conseils de résolution	Assurez-vous que les URL des produits envoyés correspondent aux pages du site Web revendiqué dans Merchant Center.
Conseils de prévention	NA