Comptes de test dans l'API Merchant

La fonctionnalité de comptes de test de l'API Merchant fournit un espace sécurisé et isolé pour tester en profondeur les intégrations avant de les déployer dans un environnement réel. En utilisant des comptes de test en bac à sable, vous pouvez tester des appels d'API, valider du code et identifier les problèmes potentiels dès le début du cycle de développement, sans affecter les données de production, perturber les opérations en temps réel ni enfreindre involontairement les règles de Merchant Center.

Prérequis

Avant de pouvoir créer et utiliser des comptes de test, assurez-vous de remplir les conditions suivantes :

  • Compte Merchant Center : vous devez disposer d'un compte Merchant Center.
  • Accès à l'API Merchant : vous devez être un utilisateur enregistré de l'API Merchant.

Avantages des comptes de test

L'utilisation de comptes de test offre plusieurs avantages clés :

  • Configuration simple : la configuration d'un compte de test est un processus peu complexe qui vous permet de commencer rapidement à tester vos fonctionnalités et intégrations.
  • Intégrité et sécurité des données : les données de production restent protégées et le risque d'infraction aux règles dans les comptes de production est éliminé.
  • Efficacité des tests : vous pouvez tester un large éventail de scénarios divers et de cas extrêmes sans avoir à gérer un compte de production parallèle à des fins de test.
  • Validation immédiate des offres : profitez de l'exemption automatique de la revendication et de la validation de la page d'accueil pour les comptes de test afin de tester rapidement les insertions d'offres. Les offres sont approuvées par défaut pour les comptes de test.
  • Simulation réaliste : l'environnement reflète le comportement de production pour les fonctionnalités critiques telles que l'importation de produits et la gestion des stocks, ce qui garantit la fiabilité des résultats des tests.
  • Migrations d'API plus fluides : les comptes de test facilitent une transition confiante et transparente pour les utilisateurs qui passent de Content API à l'API Merchant ou d'une version d'API à une autre en permettant une validation côte à côte.

Créer des comptes de test

Les comptes de test sont créés à l'aide d'une méthode personnalisée spécifique dans l'API Merchant.

Utilisez la méthode accounts.createTestAccount :

  POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
  Content-Type: application/json
  Authorization: Bearer {ACCESS_TOKEN}"

  {
    "account_name": "{TEST_ACCOUNT_NAME}",
    "time_zone": {
      "id": "America/Los_Angeles"
    },
    "language_code": "en-US"
  }

Remplacez les éléments suivants :

  • ACCOUNT_ID : votre ID Merchant Center.
  • ACCESS_TOKEN : le jeton d'autorisation pour effectuer l'appel d'API.
  • TEST_ACCOUNT_NAME : le nom du compte de test. Nous vous recommandons d'utiliser des noms explicites qui indiquent qu'ils sont utilisés à des fins de test. Par exemple, incluez le mot test dans le nom du compte de test.

Les champs suivants sont obligatoires lors de la création d'un compte de test :

  • time_zone : le fuseau horaire des rapports et de l'affichage du compte.
  • language_code : le code de langue BCP-47 du compte, tel que en-US.

Si l'appel aboutit, une ressource Account est renvoyée. Elle inclut l'accountId unique et le nom de ressource du nouveau compte de test :

  {
    "name": "accounts/{TEST_ACCOUNT_ID}",
    "accountId": "{TEST_ACCOUNT_ID}",
    "accountName": "{TEST_ACCOUNT_NAME}",
    "adultContent": false,
    "testAccount": true,
    "timeZone": {
      "id": "America/Los_Angeles"
    },
    "languageCode": "en-US"
  }

Limites

Les comptes de test sont conçus pour la validation fonctionnelle et sont soumis à des restrictions spécifiques :

  • Nombre de comptes de test : vous pouvez créer un maximum de cinq comptes de test par compte Google. Les comptes de test sont pris en compte dans votre limite par défaut de comptes Merchant Center par compte Google.
  • Intégration aux quotas de l'API Merchant : du point de vue des quotas d'API, l'API Merchant traite les comptes de test comme des comptes de production. Les comptes de test sont soumis aux mêmes quotas que les comptes de production. Il n'est pas possible d'augmenter les quotas pour les comptes de test.
  • Comptes avancés : vous ne pouvez pas créer de comptes de test avancés ni convertir un compte avancé en compte de test.
  • Aucune diffusion publique : les données envoyées à un compte de test ne seront jamais publiées sur une plate-forme Google, comme la recherche ou les annonces Shopping.
  • Points de terminaison restreints : vous ne pouvez pas utiliser de comptes de test lorsque vous utilisez certaines fonctionnalités, telles que :
  • Restrictions d'association : vous ne pouvez pas associer de comptes de test à d'autres comptes Google Ads ni à des fiches d'établissement Google.
  • Aucune inscription pour les comptes de test : vous ne pouvez pas effectuer d'inscription pour les comptes de test.

Bonnes pratiques

Nous vous recommandons de suivre certaines bonnes pratiques lorsque vous utilisez des comptes de test :

  • Développement axé sur le bac à sable : validez toujours les nouvelles fonctionnalités d'intégration dans un compte de test avant de les appliquer à votre environnement de production.
  • Tests d'intégration automatisés : utilisez des comptes de test comme environnements stables pour exécuter des tests de régression automatisés.
  • Nommage des comptes de test : utilisez account_name pour indiquer l'objectif de chaque compte de test, par exemple "Test de migration" ou "Compte de test d'intégration".