Présentation de l'API Merchant

Cette page présente l'API Merchant et explique comment l'utiliser pour automatiser divers workflows liés à la gestion des comptes, des produits et des inventaires dans Merchant Center.

Vous pouvez utiliser Merchant API pour toucher plus de clients et présenter vos produits sur Google. Vous pouvez utiliser Merchant API pour gérer des comptes Merchant Center volumineux ou complexes. Voici quelques cas d'utilisation types:

  • Gestion automatisée des comptes
  • Gestion automatisée des produits
  • Gestion automatisée de l'inventaire
  • Création de rapports personnalisés

L'API Merchant vous permet de créer et de gérer plusieurs sources de données, ce qui vous permet d'organiser mieux les informations sur les produits, les promotions et les avis. Avec l'API Merchant, vous pouvez gérer les produits de manière complémentaire aux autres méthodes d'importation des données produit, comme les fichiers et les flux automatiques.

L'API Merchant est une refonte de Content API for Shopping. Elle comprend plusieurs sous-API.

Les marchands sont tenus de respecter les règles concernant les annonces Shopping et les fiches gratuites. Google Shopping se réserve le droit de faire appliquer ces règles et de prendre les mesures appropriées si nous détectons un contenu ou un comportement qui n'y est pas conforme.

Nouveautés de l'API Merchant

Voici quelques raisons de passer à l'API Merchant:

Pour en savoir plus, consultez la page Nouvelles fonctionnalités de la version bêta de l'API Merchant.

Avant de commencer

Pour exécuter une requête API Merchant, vous devez disposer des éléments suivants:

  • Un compte Merchant Center: il s'agit du compte dans lequel vous allez interroger, mettre à jour et importer des données. Assurez-vous de disposer des autorisations nécessaires pour gérer les produits et les inventaires de ce compte.

  • Un projet Google Cloud: il permet d'obtenir un accès API à votre compte.

Authentification avec l'API Merchant

Vous pouvez utiliser les options d'authentification suivantes:

  • Vous pouvez générer un ID client et un secret OAuth 2.0 pour votre application. L'ID et le secret peuvent ensuite être utilisés pour générer les identifiants OAuth 2.0 nécessaires dans les appels d'API au compte Merchant Center.
  • Vous pouvez créer un compte de service et télécharger sa clé privée pour effectuer des appels d'API.

Identifiants de compte et de produit

L'API Merchant utilise des noms de ressources au lieu d'ID pour l'identification. Un exemple de nom de ressource pour un produit peut être accounts/123456/products/online~en~US~sku123, où 123456 est l'identifiant unique du compte et online~en~US~sku123 l'identifiant unique du produit.

Format de l'URL de la requête

Pour effectuer des opérations sur une ressource, envoyez des requêtes aux URL au format suivant:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

La partie :{METHOD} est omise pour les méthodes standards telles que list et get.

Par exemple, la requête suivante supprime l'inventaire régional:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Pour créer une ressource, vous pouvez utiliser le nom de la ressource parente et l'URL suivante:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Par exemple, la requête suivante montre comment créer une région pour accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

Pour en savoir plus sur des services spécifiques, consultez la documentation de référence de l'API Merchant.

Premiers pas avec l'API Merchant

Pour découvrir rapidement le fonctionnement de Merchant API et essayer d'importer un exemple de produit, consultez Premiers pas avec Merchant API.

Utiliser gRPC ou REST

L'API Merchant est compatible avec gRPC et REST. Voici deux façons d'effectuer des appels d'API Merchant:

gRPC (recommandé) REST
  1. Créez le corps de la requête en tant que tampon de protocole.
  2. Envoyez le corps de la requête au serveur avec HTTP/2.
  3. Désérialisez la réponse dans un tampon de protocole.
  4. Interprétez les résultats.
  1. Créez le corps de la requête en tant qu'objet JSON.
  2. Envoyez-la au serveur à l'aide de HTTP 1.1.
  3. Désérialisez la réponse en tant qu'objet JSON.
  4. Interprétez les résultats.

Utiliser des bibliothèques clientes et des exemples de code

Chaque sous-API dispose de bibliothèques clientes pour vous aider à vous lancer. Les exemples de code peuvent vous aider à commencer à écrire du code en Java, PHP et Python. Pour en savoir plus, consultez la section Exemples pour l'API Merchant.

Obtenir de l'aide

Pour obtenir de l'aide, consultez la page Obtenir de l'aide avec l'API Merchant.

Envoyer des commentaires

La période de bêta nous permet de recueillir vos commentaires et de les prendre en compte avant la disponibilité générale. Pour envoyer des commentaires, utilisez l'une des méthodes suivantes:

  • Fonctionnalités de l'API:envoyez le formulaire de commentaires.
  • Documentation:utilisez les notes sur la page et le bouton Envoyer des commentaires.
  • Exemples et bibliothèques:créez un problème dans le dépôt GitHub pour les exemples de code.

Pour nous faire part de vos commentaires généraux après avoir implémenté chaque tâche, utilisez le formulaire de commentaires.

Étape suivante

Suivant
Design