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 dans votre compte et de supprimer un produit d'une source de données.
L'API Merchant Products contient deux ressources.
productInputsreprésente les parties d'entrée de vos produits.productsreprésente les produits traités qui ont été construits à partir de vos pièces d'entrée.
productInputs peut être principal et supplémentaire, selon qu'il est importé dans une source de données principale ou une source de données supplémentaire.
Chaque product sera construit à partir d'un seul productInput principal et d'un nombre quelconque de productInputs supplémentaires.
Vous pouvez utiliser Merchant Products API pour créer des catalogues de magasins en ligne ou en magasin. Il s'agit de produits pouvant apparaître sur plusieurs sites d'achat.
Vous pouvez utiliser la ressource productInputs une fois que vous avez créé votre compte Merchant Center, configuré votre première source de données et êtes prêt à importer un ensemble initial de produits via l'API.
Bien que les marchands puissent importer des produits à l'aide d'un fichier appelé PrimaryProductDataSource, la création et la suppression de produits à l'aide de Merchant API présente plusieurs avantages. Ces avantages incluent un temps de réponse plus rapide et la possibilité de mettre à jour les produits en temps réel, sans avoir à gérer de gros fichiers. Il peut s'écouler plusieurs heures avant que les modifications apportées aux produits via des appels d'API ne soient appliquées dans la base de données Shopping.
Prérequis
Si vous ne disposez pas d'une source de données, créez-en une à l'aide de l'API Merchant DataSources ou de Merchant Center.
Si vous avez déjà créé une source de données à l'aide de l'interface utilisateur de Merchant Center ou de l'API, vous pouvez utiliser l'API Merchant Products pour ajouter vos produits. Si vous utilisez la Content API for Shopping pour ajouter des produits, consultez le guide de migration pour savoir comment commencer à utiliser l'API Merchant Products.
Vous êtes tenu de respecter les règles concernant les annonces Shopping et les fiches gratuites. 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 un contenu ou un comportement qui n'y est pas conforme.
Ressources
La ressource products vous permet de récupérer des informations produit à partir de la base de données Shopping.
La ressource productInput représente les données d'entrée que vous envoyez pour un produit. Elle fournit également des méthodes vous permettant de mettre à jour ou de supprimer des informations sur un produit, voire sur plusieurs produits en même temps, en mode par lot. Une ressource productInput doit comporter les champs suivants:
channel: canal du produit.offerId: identifiant unique du produit.contentLanguage: code de langue ISO 639-1 à deux lettres du produit.feedLabel: libellé du flux du produit.
Importer une entrée 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.
Récupérez un produit traité dans votre compte
Pour récupérer un produit traité dans votre compte, utilisez la méthode accounts.products.get. L'affichage du produit traité peut prendre plusieurs minutes après l'insertion.
Vous pouvez obtenir le nom de la ressource du produit traité à partir du champ product dans la réponse de accounts.productInputs.insert.
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 Products, vous devez transmettre l'identifiant unique de la source de données principale ou supplémentaire à laquelle le produit appartient.
Lister les produits de votre compte
Pour lister les produits traités dans votre compte, utilisez la méthode accounts.products.list.