NouveauProduct Score, 4T Segmentation, Price War et Broken Size sont disponibles.Découvrir les nouveautés
Feedance
Article

Corriger les erreurs 410 de la Content API de Google : migrer votre chaîne de flux vers Merchant API

La Content API for Shopping renvoie des erreurs 410. Repérez vos derniers appels, migrez-les vers Merchant API et vérifiez vos produits dans Merchant Center.

Cagdas PolatCagdas Polat
10 min de lecture
Corriger les erreurs 410 de la Content API de Google : migrer votre chaîne de flux vers Merchant API

La Content API for Shopping de Google a été arrêtée le 18 août 2026. Depuis le 1er septembre, les requêtes provenant de projets sans extension approuvée échouent de manière intermittente avec une erreur HTTP 410, et les endpoints seront définitivement fermés début 2027 (avis d'arrêt de Google). Si un script, un plugin ou un connecteur interne envoie encore vos produits à Merchant Center via l'ancienne API, une partie de ces mises à jour est déjà perdue.

Ce guide s'adresse aux développeurs et aux responsables de flux qui maintiennent eux-mêmes cette chaîne. À la fin, vous saurez retrouver chaque appel restant à la Content API, associer chacun à son équivalent dans Merchant API, créer la source de données qu'exige la nouvelle API et vérifier dans Merchant Center que les produits et les prix arrivent toujours.

Comment savoir si l'arrêt vous affecte

La panne passe facilement inaperçue, car elle est intermittente. Google documente le corps de l'erreur comme un code 410 avec un message qui commence par « Content API for Shopping was sunset on August 18, 2026  » et qui inclut l'ID de votre projet Google Cloud, son numéro et un lien vers le centre d'aide. Recherchez cette chaîne ainsi que shoppingcontent.googleapis.com dans les journaux de votre intégration.

Trois symptômes apparaissent généralement avant que quiconque ne lise un journal :

  • Les changements de prix ou de disponibilité arrivent chez Google avec des heures de retard, ou seulement lors de certaines exécutions.
  • Une tâche quotidienne signale un succès sur la plupart des lots et un échec sur quelques-uns.
  • Merchant Center affiche des données obsolètes alors que votre boutique affiche le bon prix.

Ce dernier symptôme a une seconde cause possible : les mises à jour automatiques des articles de Google qui écrasent vos valeurs. Nous traitons ce point séparément dans empêcher Google d'écraser silencieusement le prix et la disponibilité de votre flux. Écartez d'abord les erreurs 410, car elles sont plus simples à confirmer.

Étape 1 : recenser chaque appelant de l'ancienne API

Google recommande de passer en revue le code de votre application à la recherche d'appels directs aux endpoints de la Content API. En pratique, ces appels se cachent à quatre endroits : le plugin Google de la plateforme de votre boutique, un script personnalisé écrit par un ancien développeur, un middleware de flux ou d'ERP, et un script Google Ads ou Apps Script que quelqu'un a planifié il y a des années.

Établissez un court registre avec une ligne par appelant. Notez ce qu'il fait, le projet Google Cloud avec lequel il s'authentifie et son propriétaire. L'ID du projet est important, car les extensions et le message 410 y sont rattachés.

AppelantCe qu'il envoiePropriétaireAction
Plugin de la boutiqueCatalogue complet, quotidiennementÉditeur de la plateformeDemander quelle version d'API il utilise actuellement
Script de stockPrix et stock, toutes les heuresVotre développeurMigrer vers Merchant API
Outil de gestion de fluxFlux optimiséÉditeur de l'outilDemander une confirmation écrite de la migration

Si un prestataire gère la connexion, votre rôle est de poser la question, pas de tout reconstruire. Productsup et Feedonomics ont tous deux publié des notes sur la migration, et un prestataire mature aura déjà migré. Posez la même question à chaque prestataire de votre liste et conservez les réponses.

Étape 2 : déterminer si vous avez besoin d'une extension

Google propose un formulaire de demande d'extension de la Content API pour les organisations qui ont besoin de plus de temps. Les extensions approuvées protègent un projet des réponses d'erreur planifiées pendant la période accordée, mais elles ne vont pas au-delà de la mise hors service définitive début 2027. Google ne précise pas qui y est éligible.

Appliquez cette règle de décision. Si chaque appelant peut être migré et testé en quelques semaines, passez-vous de l'extension et consacrez ce temps à la migration. Si un appelant appartient à un prestataire dont la migration est confirmée mais non planifiée, demandez une extension pour ce projet uniquement. Une extension est une marge de sécurité, pas un plan.

Étape 3 : associer chaque appel à son équivalent dans Merchant API

Merchant API découpe l'ancien monolithe en sous-API et versionne l'URL (/products/v1/). La version v1 est disponible en version générale depuis juillet 2025 et la v1beta a été arrêtée le 28 février 2026 : développez donc sur la v1 et ignorez les tutoriels v1beta que vous pourriez trouver (notes de version de Merchant API).

Content APIMerchant APICe qui change
products.insertproductInputs.insertNécessite un paramètre de requête dataSource
products.updateproductInputs.patchMise à jour persistante d'une entrée produit
products.deleteproductInputs.deleteNécessite un paramètre dataSource
products.get / listproducts.get / listRenvoie le produit traité, en lecture seule
productstatuses.get / listproducts.get / listLe statut fait désormais partie de la ressource Product
custombatchAppels asynchrones parallèlesIl n'existe pas de méthode customBatch
datafeedsdataSourcesChaque source de données cible un seul libellé de flux et une seule langue

Source : la correspondance de migration des produits et la correspondance des sources de données de Google. Le changement conceptuel réside dans la distinction entre un ProductInput, qui correspond aux données brutes que vous écrivez, et un Product, qui est le résultat traité que vous pouvez seulement lire. Un produit traité est construit à partir d'une entrée principale et d'éventuelles entrées supplémentaires, après application des règles de flux (présentation des produits).

Étape 4 : créer la source de données API avant toute insertion

C'est l'étape qui fait échouer la plupart des premières migrations. La Content API créait automatiquement une source de données « Content API  » lors de votre première insertion. Merchant API ne le fait pas. Google indique que vous devez créer au moins une source de données de type API, et que la sous-API Products ne peut écrire que dans des sources de données de ce type (migration des sources de données).

Chaque source de données correspond désormais à une seule combinaison de feedLabel et de contentLanguage. Si vous serviez la Turquie en turc et les Émirats arabes unis en anglais à partir d'un seul flux multicible, il vous faut maintenant des sources de données distinctes. Créez-les via la sous-API Data Sources ou dans Merchant Center, puis utilisez le nom de ressource obtenu, sous la forme accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}, pour chaque écriture.

Étape 5 : réécrire le payload, avec un exemple concret

Trois changements de champs sont à l'origine de la plupart des bugs. Le prix passe d'une chaîne décimale à des micros entiers, un million de micros correspondant à une unité monétaire. Les attributs produits sont déplacés dans un objet productAttributes. Et targetCountry est remplacé par feedLabel, tandis que channel disparaît.

L'ancien identifiant produit ressemblait à ceci ; le nouveau utilise des tildes et abandonne le canal :

Content API:  online:en:US:SKU12345
Merchant API: en~US~SKU12345

Une entrée produit, telle que celle que le guide de Google prend pour exemple, se présente ainsi (insertion avec POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}) :

{
  "offerId": "SKU12345",
  "contentLanguage": "en",
  "feedLabel": "US",
  "productAttributes": {
    "title": "Classic Cotton T-Shirt",
    "link": "https://www.example.com/p/SKU12345",
    "imageLink": "https://www.example.com/img/SKU12345.jpg",
    "availability": "IN_STOCK",
    "price": { "amountMicros": "15990000", "currencyCode": "USD" },
    "condition": "NEW",
    "gtins": ["9780007350896"]
  }
}

Comparez avec l'ancien format : "price": {"value": "15.99", "currency": "USD"} devient amountMicros et currencyCode, et la disponibilité devient une énumération, si bien que in stock devient IN_STOCK. Source : guide de Google sur l'ajout et la gestion des produits.

Pour la livre turque, 1 249,90 TRY correspond à "amountMicros": "1249900000". Calculez les micros avec une arithmétique entière sur l'unité mineure, et non en multipliant un nombre à virgule flottante, sinon vous enverrez 1249899999 et vous vous demanderez pourquoi les prix diffèrent d'un cheveu.

Utilisez aussi le nouveau champ versionNumber lorsque plusieurs tâches écrivent le même produit. Il empêche une mise à jour plus ancienne d'écraser une plus récente lorsque les requêtes arrivent dans le désordre.

Étape 6 : remplacer le traitement par lots et lire le statut depuis le produit

Il n'existe pas de customBatch. Remplacez-le par des requêtes asynchrones parallèles en limitant la concurrence, puis ne relancez que les échecs. Tenez un journal des résultats par offre, pour qu'un échec partiel ne se transforme pas silencieusement en catalogue obsolète.

Pour le statut, cessez d'appeler productstatuses. Lisez plutôt le Product traité, qui porte son statut. Google précise qu'il peut s'écouler quelques minutes entre une insertion ou une mise à jour et la disponibilité du produit final : une lecture immédiatement après une écriture ne permet donc pas de conclure à un échec.

Étape 7 : vérifier avant de désactiver l'ancien circuit

Testez d'abord le nouveau circuit sur un petit échantillon à faible risque, par exemple 50 produits d'un seul libellé de flux. Évaluez ensuite la bascule à l'aide de cette liste de contrôle. Chaque ligne doit être validée avant de retirer l'ancien appelant.

  • L'appelant s'authentifie auprès du projet que vous avez enregistré et ne renvoie aucune erreur 410 pendant sept jours consécutifs.
  • Une source de données API existe pour chaque couple libellé de flux / langue que vous servez.
  • Pour l'échantillon de test, le produit traité correspond à votre source de référence pour le prix, la disponibilité et le lien.
  • Plus rien n'écrit encore les mêmes ID d'offre depuis l'ancienne source de données.
  • Les offres en échec sont journalisées avec une nouvelle tentative, et non abandonnées.
  • Les appelants gérés par des prestataires figurant dans votre registre disposent tous d'une confirmation écrite de migration.

Le quatrième point mérite une attention particulière. Un second auteur d'écriture pour le même ID d'offre, par exemple l'ancien appelant et une nouvelle source de données API, est précisément ce qui génère des valeurs contradictoires. Décidez quelle source est propriétaire de chaque produit et supprimez l'autre.

Les limites de ce guide

Nous avons rédigé ce guide à partir de la documentation publiée par Google et n'avons pas migré votre code. Plusieurs éléments en sortent. Google ne précise pas les critères d'éligibilité aux extensions : nous ne pouvons donc pas vous dire si un projet donné sera approuvé. La présentation des produits ne documente pas les délais au-delà de « quelques minutes  » : toute exigence de latence plus stricte est donc à mesurer de votre côté. L'inventaire local, l'inventaire régional, les promotions et les avis disposent chacun de leurs propres sous-ressources dans Merchant API, et nous n'avons pas couvert leurs correspondances ici.

Si vous ne souhaitez pas du tout gérer une intégration API, une plateforme de gestion de flux managée est une meilleure réponse qu'une réécriture. Productsup et Feedonomics publient tous deux des conseils de migration vers Merchant API, et pour une équipe grand compte aux modèles de données atypiques, l'un ou l'autre peut mieux convenir que notre solution. Pour Google Shopping en particulier, notre propre configuration est décrite sur la page d'intégration Google Merchant Center.

Questions fréquentes

La Content API for Shopping fonctionne-t-elle encore ?

Pas de manière fiable. Google indique qu'elle a été arrêtée le 18 août 2026, que les requêtes sans extension active ont commencé à échouer de manière intermittente avec une erreur HTTP 410 à partir du 1er septembre 2026, et que tous les endpoints seront fermés début 2027.

Que dit l'erreur 410 de la Content API ?

Le message commence par « Content API for Shopping was sunset on August 18, 2026  ». La réponse inclut l'ID de votre projet GCP, son numéro et un lien vers le centre d'aide, ce qui vous indique quel projet migrer ou prolonger.

Puis-je obtenir plus de temps grâce à une extension ?

Google propose un formulaire de demande d'extension de la Content API. Les extensions approuvées protègent votre projet des erreurs planifiées uniquement pendant la période accordée, et elles ne vont pas au-delà de la mise hors service de début 2027.

Pourquoi productInputs.insert demande-t-il une dataSource ?

Les écritures dans Merchant API appartiennent à une source de données explicite. Contrairement à l'ancienne API, elle ne crée pas de source de données « Content API  » lors de votre première insertion : vous devez donc créer une source de données de type API et transmettre son nom de ressource.

Comment envoyer les prix dans Merchant API ?

Utilisez amountMicros sous forme de chaîne d'entier et currencyCode au format ISO 4217. Un million de micros équivaut à une unité monétaire : 15.99 USD correspond donc à 15990000.

Merchant API prend-il en charge le traitement par lots ?

Il n'existe pas de méthode customBatch. Google recommande d'utiliser des appels parallèles asynchrones, ce qui signifie que vous devez ajouter votre propre limite de concurrence et des relances par offre.

Où est passé productstatuses ?

Le statut fait désormais partie de la ressource Product traitée. Utilisez products.get ou products.list pour le lire, en gardant à l'esprit que le traitement peut accuser quelques minutes de retard après une insertion.

Sur quelle version de Merchant API faut-il développer ?

Développez sur la v1, disponible en version générale depuis juillet 2025. La version v1beta a été arrêtée le 28 février 2026 : les tutoriels écrits pour elle ne fonctionneront pas.

Vérifiez ce que Google voit réellement

Après la migration, le contrôle de cohérence le plus rapide consiste à comparer votre flux source avec ce que Merchant Center a traité. Passez votre flux en production dans notre outil gratuit d'audit de flux produits pour obtenir un score de complétude et de qualité, et corrigez tout ce qu'il signale avant le prochain cycle publicitaire.

Vous souhaitez un regard extérieur sur votre flux ? Nous l'examinerons avec vous et vous montrerons ses lacunes avant votre prochaine soumission.
Lancer un audit gratuit
Cagdas Polat
Écrit par
Cagdas Polat

Cofondateur de Feedance, il s'appuie sur son double parcours d'ingénieur informatique et de marketeur pour produire des analyses approfondies. Résolument attaché à transformer les données en stratégies concrètes, il s'engage à aider les marques à réaliser une croissance significative dans l'univers numérique.

LinkedIn

Découvrez quels
produits rapportent.

Connectez votre flux et GA4. Nous affichons Product Score, 4T, Price War et Broken Size sur votre propre catalogue.