Sur cette page, nous vous fournissons des conseils pour planifier la migration de votre API.
Nous vous présenterons ensuite les étapes à suivre pour effectuer la migration.
Préparer la migration
Associez vos méthodes Content API for Shopping à vos méthodes Merchant API.
Il est très utile de bien comprendre les nouvelles méthodes et ressources dont vous avez besoin pour l'API Merchant.
Découvrez les changements les plus importants qui s'appliquent à votre migration.
Nous vous recommandons de consulter et de garder à l'esprit les ressources suivantes, car elles vous seront utiles pour votre migration :
- Migrer depuis Content API : cette page décrit les principaux changements à connaître dans l'API Merchant.
- 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, comme les nouveaux mappages de champs. Pour obtenir un exemple, consultez Migrer la gestion des produits.
- La documentation de référence de l'API Merchant fournit des informations détaillées sur les ressources et les méthodes de l'API Merchant.
- Le guide de démarrage rapide explique comment commencer rapidement à utiliser l'API Merchant pour créer un compte et importer un exemple de produit.
- Guides spécifiques aux fonctionnalités : pour implémenter une nouvelle fonctionnalité ou obtenir plus d'informations, vous pouvez consulter les guides correspondants dans le menu de navigation.
Identifiez les sous-API que vous prévoyez de migrer et d'implémenter.
Déterminez deux éléments :
- Fonctionnalités de l'API Merchant que vous devez migrer
- Les nouvelles fonctionnalités que vous souhaitez implémenter
Une fois que vous avez fait cela, vous pouvez déterminer la quantité d'efforts et 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 l'API Content dans un premier temps, en raison de son importance et de sa complexité, privilégiez les sous-API suivantes.
Étapes de migration
S'inscrire en tant que développeur Pour utiliser l'API Merchant, 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 l'API Merchant. Pour en savoir plus sur l'ensemble de la procédure, cliquez ici.
Testez différentes méthodes pour vous aider à monter en puissance. Nous vous recommandons d'utiliser l'explorateur d'API Google pour effectuer des tests de base.
Le format des URL de requête pour l'API Merchant est le suivant :
https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…Exploitez nos exemples de code et nos bibliothèques clientes.
Pour réduire le temps d'implémentation et profiter 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. Pour obtenir un 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-les uniquement pour un petit segment de votre activité à la fois.
- Surveillez les problèmes à tout moment.
Implémenter votre 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 publication, intégrez l'API Merchant à vos workflows.
Surveillance
Préparez-vous à résoudre les problèmes potentiels.