La sous-API Products vous permet de gérer par programmation votre inventaire de produits dans Google Merchant Center. Vous pouvez créer, récupérer, mettre à jour et supprimer des produits, ce qui vous offre la possibilité d'intégrer vos systèmes directement à Google.
Un concept clé de l'API Merchant est la distinction entre les données que vous envoyez et le produit final utilisé par Google. Cette séparation fournit un modèle plus clair du cycle de vie des données produit et vous permet de contrôler plus précisément les informations sur vos produits. L'API reflète cela avec deux ressources principales :
ProductInput: représente les données produit brutes que vous envoyez à une source de données spécifique. Il s'agit de la ligne que vous importez dans un fichier de flux ou des données que vous envoyez avec un appel d'API avant tout traitement par Merchant Center. Vous utilisez cette ressource pour toutes les opérations d'écriture (insert,patch,delete).Product: ressource en lecture seule qui représente le produit final traité tel qu'il apparaît dans Merchant Center et sur les surfaces Google. Elle est créée à partir d'une ressourceProductInputprincipale et d'une ou plusieurs ressourcesProductInputsupplémentaires une fois toutes les règles et tous les traitements de flux appliqués. Cette ressource inclut l'état final du produit et tous les problèmes de qualité des données. Vous utilisez cette ressource pour toutes les opérations de lecture (get,list).
Le format et les exigences pour tous les attributs de produit envoyés à l'aide de la
ProductInput ressource sont définis dans les
spécifications des données produit.
Qu'est-il possible de faire avec la sous-API Products ?
La sous-API Products vous permet d'effectuer les tâches clés suivantes. Consultez les guides pour obtenir des instructions détaillées et des exemples de code pour chaque cas d'utilisation.
- Ajouter et gérer des produits : découvrez comment ajouter de nouveaux produits à votre compte, fournir des données supplémentaires pour les produits existants et supprimer les produits que vous ne vendez plus.
- Mettre à jour fréquemment vos produits : découvrez comment effectuer des mises à jour partielles efficaces des attributs de produit qui changent souvent, comme le prix et la disponibilité.
- Lister vos données produit et les problèmes liés aux produits : découvrez comment récupérer vos produits traités, vérifier leur état d'approbation pour différentes destinations et identifier les problèmes de qualité des données qui peuvent affecter leur visibilité.
Avant de commencer
Avant d'utiliser la sous-API Products, vous devez créer au moins une source de données API dans votre compte Merchant Center. La sous-API Products ne peut insérer ou mettre à jour des produits que dans des sources de données de type API. Pour obtenir des instructions, consultez
le guide Gérer les sources de données API pour les importations de produits.