Premiers pas avec l'API Merchant Center

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

Voici comment utiliser Merchant API:

Utiliser des bibliothèques clientes

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

Chaque sous-API est accompagnée d'exemples de code et de bibliothèques clientes pour vous aider à vous lancer.

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 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}

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érialisez la réponse dans 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érialisez 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 rien d'autre à faire 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.

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:utilisez le bouton Nouveau problème sur GitHub.

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