Premiers pas avec l'API Merchant Center

Pour commencer, activez l'API Merchant dans votre projet Cloud.

Pour utiliser l'API Merchant Center, procédez comme suit:

Utiliser des bibliothèques clientes

L'API Merchant Center est constituée de plusieurs sous-API.

Chaque sous-API dispose d'exemples de code et de bibliothèques clientes pour vous aider à démarrer.

Si vous utilisez déjà Content API for Shopping, consultez la page Compatibilité de Content API for Shopping.

Envoyer des requêtes

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/123/products/online~en~US~sku123, où 123 est l'identifiant unique du compte et online~en~US~sku123 l'identifiant unique du produit.

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}

Remarque :La partie :{method} est omise pour les méthodes standards.

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

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/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, voici comment créer une région pour account/123

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

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

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
Créez le corps de la requête en tant que tampon de protocole. 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. Envoyez-la au serveur à l'aide de HTTP 1.1. Désérialiser la réponse en tant qu'objet JSON Interprétez les résultats.

Remarque :Si vous utilisez une bibliothèque cliente, le mécanisme de transport par défaut est gRPC. Dans la plupart des cas, vous n'avez besoin de rien d'autre que d'appeler les points de terminaison de l'API Merchant pour utiliser gRPC.

Obtenir de l'aide

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

Donner votre avis

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 notes sur la page et le bouton Envoyer des commentaires.
• Exemples et bibliothèques:utilisez le bouton Nouveau problème sur GitHub.

Pour envoyer des commentaires d'ordre général après la mise en œuvre de chaque tâche, utilisez le formulaire de commentaires.