Présentation de l'API Merchant

Vous pouvez utiliser Merchant API pour :

  • Gérez la façon dont votre établissement et vos produits apparaissent sur Google.
  • Accédez par programmation à des données, des insights et des fonctionnalités uniques.
  • Développez votre activité et touchez plus de clients sur Google.

Merchant API peut 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 automatique de l'inventaire
  • Gestion automatisée des rapports sur les performances et les insights sur le marché

Merchant API vous permet de créer et de gérer plusieurs sources de données, ce qui vous aide à mieux organiser les informations sur les produits, les promotions et les avis. Merchant API vous permet de gérer les produits de manière complémentaire aux autres méthodes d'importation de données produit, comme les fichiers et les flux automatiques. L'API Merchant vous permet également d'exécuter plusieurs requêtes individuelles en parallèle.

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

Nouveautés de l'API Merchant

Voici quelques raisons de passer à Merchant API :

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 sur 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 : utilisez le projet pour accéder à l'API de votre compte.

  • Un lien entre votre compte Merchant Center et le projet Google Cloud. Créez l'association en appelant la méthode d'enregistrement du développeur. Vous utiliserez ce compte et ces utilisateurs pour les communications concernant l'intégration de l'API, les enquêtes et les opportunités.

  • Associez votre compte Merchant Center au projet Google Cloud en vous inscrivant en tant que développeur. Les utilisateurs disposant du rôle de développeur d'API recevront des communications sur l'API, y compris des annonces obligatoires sur le service, des enquêtes à leur attention et des opportunités.

Authentification avec l'API Merchant

Vous pouvez utiliser les options suivantes pour l'authentification :

  • 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 aux appels d'API vers le 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. Par exemple, le nom de ressource d'un produit peut être accounts/123456/products/en~US~sku123, où 123456 est l'identifiant unique du compte et en~US~sku123 est l'identifiant unique du produit.

Format d'URL de requête

Pour agir 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/v1/accounts/123456/products/en~US~sku123/regionalInventories/456

Pour créer une ressource, utilisez 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/v1/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 les 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érialiser 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 à démarrer. Les exemples de code peuvent vous aider à commencer à écrire du code en Java, PHP et Python. Pour en savoir plus, consultez Exemples pour l'API Merchant.

Obtenir de l'aide

Pour savoir comment obtenir de l'aide, consultez Obtenir de l'aide concernant Merchant API.

Envoyer des commentaires

Pour envoyer des commentaires, envoyez l'un des éléments suivants :

  • Fonctionnalités de l'API : sélectionnez l'option Envoyer des commentaires dans la section Quel est le problème/la question ? du formulaire de commentaires.
  • Documentation : utilisez les boutons "J'aime" et "Je n'aime pas" de la page, ainsi que le bouton Envoyer des commentaires.
  • Exemples et bibliothèques : signalez un problème dans le dépôt GitHub pour les exemples de code.

Étape suivante

Suivant
Merchant API terms and conditions