Cette page explique comment importer et gérer vos produits de manière programmatique. L'API Merchant Products vous permet d'insérer ou de mettre à jour un produit dans une source de données, de récupérer un produit de votre compte et de supprimer un produit d'une source de données.
Vous pouvez utiliser la ressource products pour créer un catalogue de boutique en ligne, c'est-à-dire une liste des produits disponibles dans les annonces Shopping. Vous pouvez utiliser la ressource products une fois que vous avez créé votre compte Merchant Center et que vous êtes prêt à importer un ensemble initial de produits via l'API.
Vous devez respecter les règles relatives aux annonces Shopping et aux fiches sans frais. Les annonces Shopping se réservent le droit de faire appliquer ces règles et de prendre les mesures appropriées si nous détectons du contenu ou un comportement qui ne les respecte pas.
La ressource products importe les informations produit dans la base de données Merchant Center de Shopping. Elle fournit également un certain nombre de méthodes qui vous permettent d'accéder, de mettre à jour ou de supprimer les informations produit une par une, ou plusieurs à la fois, en mode par lot.
La ressource productInput représente les données d'entrée que vous envoyez pour un produit. Une ressource productInput doit comporter les champs suivants:
channel: canal du produitofferId: identifiant unique du produit Cette valeur est identique pour l'entrée de produit et le produit traité.contentLanguage: code de langue ISO 639-1 à deux lettres du produit.feedLabel: libellé du flux du produit
Bien que les marchands puissent charger des produits à l'aide d'un fichier appelé flux principal, créer et supprimer des produits avec l'API Merchant Center présente plusieurs avantages. Ces avantages incluent un temps de réponse plus rapide et la possibilité de mettre à jour plusieurs produits en temps réel, sans avoir à gérer plusieurs flux supplémentaires. Il peut s'écouler plusieurs heures avant que les modifications apportées aux produits via des appels d'API ne s'affichent dans la base de données Merchant Center de Shopping.
Google peut vous aider à gérer automatiquement certains attributs de vos produits. Pour en savoir plus, consultez la section Activer les améliorations automatiques.
Prérequis
Si vous n'avez pas de source de données, créez-en une à l'aide de l'API Merchant Data Source ou de Merchant Center.
Si vous disposez déjà d'une source de données que vous avez créée à l'aide de l'interface utilisateur de Merchant Center ou de l'API, vous pouvez ajouter vos produits à l'aide de l'API Merchant Products. Si vous utilisez Content API for Shopping pour ajouter des produits, consultez le guide de migration pour découvrir comment vous lancer avec l'API Merchant Products.
Importer une entrée de produit dans votre compte
Pour importer une entrée de produit dans votre compte, utilisez la méthode accounts.productInputs.insert. Vous devez transmettre l'identifiant unique de la source de données principale ou supplémentaire pour insérer un produit à l'aide de Merchant Products API.
Récupérer un produit traité à partir de votre compte
Pour récupérer un produit traité à partir de votre compte, utilisez la méthode accounts.products.get. L'affichage du produit traité peut prendre plusieurs minutes après son insertion.
Supprimer une entrée de produit de votre compte
Pour supprimer une entrée de produit de votre compte, utilisez la méthode accounts.productInputs.delete. Pour supprimer un produit à l'aide de l'API Merchant Center, vous devez transmettre l'identifiant unique de la source de données principale ou supplémentaire à laquelle appartient le produit.
Lister les produits de votre compte
Pour répertorier les produits traités dans votre compte, utilisez la méthode accounts.products.list.