Comptes de test dans l'API Merchant

La fonctionnalité de comptes de test de l'API Merchant offre un espace sécurisé et isolé pour tester minutieusement 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 en amont du cycle de développement, sans impacter 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 présente plusieurs avantages clés :

  • Configuration simple : la configuration du compte de test est un processus peu complexe qui vous permet de commencer rapidement à tester vos fonctionnalités et vos intégrations.
  • Intégrité et sécurité des données : les données de production restent protégées, et le risque de non-respect des 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 permettent une transition fiable et fluide pour ceux qui passent de Content API à Merchant API 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 : jeton d'autorisation pour effectuer l'appel d'API
  • TEST_ACCOUNT_NAME : 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 lorsque vous créez un compte de test :

  • time_zone : fuseau horaire utilisé pour les rapports et l'affichage du compte.
  • language_code : code de langue BCP-47 pour le 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 jusqu'à cinq comptes de test par compte Google. Les comptes tests 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 avec certaines fonctionnalités, comme :
  • Restrictions d'association : vous ne pouvez pas associer de comptes tests à d'autres comptes Google Ads ni à des fiches d'établissement Google.
  • Pas d'enregistrement pour les comptes de test : vous ne pouvez pas enregistrer de 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".