Cette page fournit des conseils pour planifier la migration de votre API et décrit les étapes requises.
Préparer la migration
Mappez vos méthodes Content API for Shopping avec les méthodes Merchant API.
Comprenez les nouvelles méthodes et ressources requises pour Merchant API.
Découvrez les changements les plus importants qui s'appliquent à votre migration.
Consultez les ressources suivantes pour vous aider à effectuer la migration :
- Migrer depuis Content API : cette section détaille les principaux changements à prendre en compte 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 à utiliser rapidement 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 des fonctionnalités fournis dans la navigation.
Identifiez les sous-API que vous prévoyez de migrer et que vous souhaitez implémenter.
Déterminez deux choses :
- Fonctionnalités de Merchant API vers lesquelles vous devez migrer
- Les nouvelles fonctionnalités que vous souhaitez implémenter
Une fois cette étape terminée, vous pouvez déterminer la quantité d'efforts à fournir et établir une liste de priorités des sous-API sur lesquelles travailler.
Si vous ne pouvez pas migrer l'intégralité de votre implémentation de Content API dans un premier temps, priorisez les sous-API suivantes en fonction de leur importance et de leur complexité.
Procédure de migration
S'enregistrer en tant que développeur Pour utiliser la 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 l'API Merchant. Vous pouvez suivre l'ensemble du processus sur la page "Vue d'ensemble".
Testez différentes méthodes pour vous aider à vous lancer. Nous vous recommandons d'utiliser Google APIs Explorer 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}…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.
Les guides incluent des extraits d'exemples de code. Par exemple, consultez Ajouter un produit.
Testez des parcours utilisateur simples.
Testez le 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 sur un petit segment de l'entreprise à la fois.
- Surveillez l'apparition d'éventuels problèmes.
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 l'élaboration d'un plan de publication, intégrez l'API Merchant à vos workflows.
Surveiller
Préparez-vous à résoudre les éventuels problèmes.