Sur cette page, nous vous expliquons comment planifier la migration de votre API.
Nous vous présentons ensuite les étapes à suivre pour effectuer la migration.
Préparer la migration
Mappez vos méthodes Content API for Shopping avec les méthodes Merchant API.
Il est très utile de bien comprendre les nouvelles méthodes et ressources dont vous avez besoin pour Merchant API.
Comprenez les changements les plus importants qui s'appliquent à votre migration.
Nous vous recommandons de consulter les ressources suivantes et de les garder à l'esprit, car elles vous seront utiles pour votre migration :
- Migrer depuis Content API (présentation) : cette page décrit les principaux changements à connaître dans Merchant API.
- Guides de migration spécifiques aux sous-API : consultez les guides de migration spécifiques aux sous-API dont vous avez besoin, car ils fournissent des informations essentielles, telles que les nouveaux mappages de champs. Pour obtenir un exemple, consultez Migrer la gestion des produits.
- La documentation de référence de Merchant API fournit des informations détaillées sur les ressources et les méthodes de Merchant API.
- Le guide de démarrage rapide explique comment commencer rapidement à utiliser Merchant API pour créer un compte et importer un exemple de produit.
- Guides spécifiques aux fonctionnalités : pour mettre en œuvre une nouvelle fonctionnalité ou obtenir plus d' informations, vous pouvez consulter les guides de fonctionnalités fournis dans le menu de navigation.
Identifiez les sous-API que vous prévoyez de migrer et que vous souhaitez mettre en œuvre.
Déterminez deux éléments :
- Les fonctionnalités de Merchant API que vous devez migrer
- Les nouvelles fonctionnalités que vous souhaitez mettre en œuvre
Une fois que vous avez fait cela, vous pouvez déterminer l'effort à fournir et établir une liste de priorité des sous-API sur lesquelles travailler.
Nous vous recommandons de tout migrer, ou autant que possible. Si vous ne pouvez pas migrer l'intégralité de votre implémentation de Content API au départ, en raison de son importance et de sa complexité, donnez la priorité aux sous-API suivantes.
Procédure de migration
Inscrivez-vous en tant que développeur. Pour utiliser Merchant API, vous devez créer un lien entre votre projet Google Cloud et votre compte Merchant Center principal. Cette inscription unique est requise pour chaque projet Google Cloud que vous utilisez avec Merchant API. Vous pouvez suivre l'ensemble de la procédure ici.
Testez différentes méthodes pour vous aider à monter en compétence. Nous vous recommandons d'utiliser Google Explorateur d'API pour effectuer des tests de base.
Le format des URL de requête pour Merchant API est
https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…Utilisez nos exemples de code et nos bibliothèques clientes.
Pour réduire le temps d'implémentation et bénéficier de gRPC, utilisez les bibliothèques clientes et les exemples de code.
Nous intégrons également des extraits d'exemples de code dans nos guides. Par exemple, consultez Ajouter un produit.
Testez des parcours utilisateur simples.
Effectuez des tests de parcours utilisateur sur toutes les sous-API et fonctionnalités que vous prévoyez de migrer, avec les objectifs suivants :
- Vos ressources et appels migrés ont des résultats de réponse corrects.
- Le taux d'erreur reste faible.
Planifier votre déploiement
Nous recommandons l'approche suivante :
- Implémentez une sous-API ou une méthode à la fois.
- Implémentez-la uniquement sur un petit segment de l'entreprise à la fois.
- Surveillez les problèmes en permanence.
Effectuer la migration
Travaillez sur le codage à l'aide des nouvelles ressources et des nouveaux points de terminaison.
Après les tests initiaux et le développement d'un plan de lancement, intégrez Merchant API à vos workflows.
Surveillez.
Préparez-vous à résoudre les problèmes potentiels.