Lancer la migration

Cette page vous guide dans la planification de la migration de votre API et décrit les étapes requises.

Préparer la migration

  1. Mappez vos méthodes Content API for Shopping avec les méthodes Merchant API.

    Découvrez les nouvelles méthodes et ressources requises pour Merchant API.

  2. Découvrez les modifications les plus importantes qui s'appliquent à votre migration.

    Consultez les ressources suivantes pour vous aider à effectuer 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 nouvelles correspondances 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 l'API Merchant pour créer un compte et importer un exemple de produit.
    • Guides spécifiques aux fonctionnalités : pour implémenter de nouvelles fonctionnalités ou obtenir plus d'informations, vous pouvez consulter les guides correspondants dans le menu de navigation.
  3. 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 que vous devez migrer
    • Les nouvelles fonctionnalités que vous souhaitez implémenter

    Une fois cette opération effectuée, vous pouvez déterminer la charge de travail et une liste de priorité des sous-API sur lesquelles travailler.

    Si vous ne pouvez pas migrer l'intégralité de votre implémentation de l'API Content dans un premier temps, privilégiez les sous-API suivantes en fonction de leur importance et de leur complexité.

Procédure de migration

  1. S'inscrire 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.

  2. Testez différentes méthodes pour vous aider à vous familiariser avec les campagnes. Nous vous recommandons d'utiliser l'explorateur d'API Google pour effectuer des tests de base.

    Le format des URL de requête pour Merchant API est le suivant :

    https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}
    
  3. 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.

    Les guides incluent des extraits d'exemple de code. Par exemple, consultez Ajouter un produit.

  4. 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 l'entreprise à la fois.
  • Surveillez les problèmes à tout moment.

Implémenter votre migration

  1. 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.

  2. Surveiller

    Préparez-vous à résoudre les problèmes potentiels.