Cette page a été traduite par l'API Cloud Translation.

Présentation de l'API Merchant

Cette page présente l'API Merchant Center 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 l'API Merchant Center pour toucher plus de clients et présenter vos produits sur Google. Vous pouvez utiliser l'API Merchant pour gérer des comptes Merchant Center volumineux ou complexes. Voici quelques cas d'utilisation types:

Gestion automatisée du compte
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 permet une meilleure organisation des informations sur les produits, des promotions et des avis. Avec l'API Merchant Center, vous pouvez gérer vos produits en complément d'autres méthodes d'importation de données produit, comme les fichiers et le flux automatique. L'API Merchant Center vous permet également d'exécuter plusieurs requêtes individuelles en parallèle.

L'API Merchant Center est une refonte de Content API for Shopping et 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 d'appliquer ces règles et de prendre les mesures appropriées si nous détectons du contenu ou des comportements qui ne les respectent pas.

Nouveautés de l'API Merchant Center

Voici quelques raisons de passer à l'API Merchant Center:

Meilleure gestion des données d'inventaire grâce à l'introduction des nouvelles méthodes suivantes:
Permet de gérer les sources de données supplémentaires en créant et en récupérant des sources de données supplémentaires, et en associant des sources de données supplémentaires à des sources de données principales.
Active les notifications en cas de modification de vos données produit. Vous n'avez ainsi plus besoin d'une récupération périodique en vous informant en cas de changement de l'état d'un produit.
Présente la ressource et les méthodes accounts.autofeedSettings pour récupérer et mettre à jour les paramètres de flux automatique.
Cette fonctionnalité permet d'importer des avis sur les produits et des avis sur les marchands.
Ressource accounts.products simplifiée avec l'introduction de la ressource accounts.productInputs.
Permet de mettre à jour les données produit conjointement avec d'autres méthodes d'importation de données telles que les fichiers.
Nouvelle table NonProductPerformanceView pour les données hors performances des produits, telles que les informations sur le trafic entrant vers le site Web d'un marchand.
Conception modulaire avec des améliorations de fonctionnalités isolées et plus fréquentes.
Alignement amélioré sur les propositions d'amélioration des API de Google.
Mise à jour de la documentation et des exemples de code

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

Avant de commencer

Pour exécuter une requête API Merchant Center, 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 dans ce compte.
Un projet Google Cloud: le projet permet d'obtenir l'accès API à votre compte.

Authentification avec l'API Merchant

Vous pouvez utiliser les options d'authentification suivantes:

Vous pouvez générer un code secret et un ID client OAuth 2.0 pour votre application. Ces identifiants peuvent ensuite être utilisés pour générer les identifiants OAuth 2.0 nécessaires pour 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 codes produit

L'API Merchant Center utilise des noms de ressources au lieu d'ID pour l'identification. Voici un exemple de nom de ressource pour un produit : 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 requête

Pour effectuer une opération 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 ressource 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 Center

Pour découvrir rapidement comment fonctionne l'API Merchant Center et essayer d'importer un exemple de produit, consultez Premiers pas avec l'API Merchant Center.

Utiliser gRPC ou REST

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

gRPC (recommandé)	REST
Créez le corps de la requête en tant que "protocol buffer". Envoyez le corps de la requête au serveur avec HTTP/2. Désérialiser la réponse à un tampon de protocole Interprétez les résultats.	Créez le corps de la requête en tant qu'objet JSON. L'envoyer au serveur via HTTP 1.1. Désérialiser la réponse en tant qu'objet JSON 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 à démarrer. Les exemples de code peuvent vous aider à écrire du code en Java, PHP et Python. Pour en savoir plus, consultez la page Exemples pour l'API Merchant Center.

Obtenir de l'aide

Pour accéder à des ressources d'assistance, consultez Obtenir de l'aide concernant l'API Merchant.

Envoyer des commentaires

La phase bêta nous permet de recueillir vos commentaires et d'y répondre avant le lancement en disponibilité générale. Pour envoyer des commentaires, envoyez l'un des éléments suivants:

Fonctionnalités de l'API:envoyez le formulaire de commentaires.
Documentation:Utilisez les bulles d'évaluation intégrées à 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 envoyer des commentaires d'ordre général après la mise en œuvre de chaque tâche, utilisez le formulaire de commentaires.

Étape suivante

Pour en savoir plus sur la rétrocompatibilité, consultez la section Compatibilité de Content API for Shopping.
Pour en savoir plus sur les principales fonctionnalités de l'API Merchant, consultez les guides dans le menu de navigation de gauche.
Pour en savoir plus sur les ressources et services disponibles, consultez la documentation de référence.

Design